當使用者訪問圖片處理服務出現錯誤的時候,圖片處理服務會返回給使用者相應的錯誤碼和錯誤資訊,以幫助使用者定位與處理問題。

圖片處理服務錯誤的響應格式

錯誤響應的消息體例子:

<Error>
  <Code>BadRequest</Code>
  <Message>Input is not base64 decoding.</Message>
  <RequestId>52B155D2D8BD99A15D0005FF</RequestId>
  <HostId>userdomain</HostId>
</Error>

錯誤包含以下元素:

  • Code: 圖片處理服務返回給使用者的錯誤碼。
  • Message: 圖片處理服務給出的詳細錯誤資訊。
  • RequestId: 用以標識錯誤請求的唯一UUID,在無法解決問題時候,可以使用此錯誤ID發送給圖片處理服務的工程師去定位錯誤的原因。
  • HostId:用來標識訪問的圖片處理服務叢集。

圖片處理服務的錯誤碼

錯誤碼 描述 HTTP 狀態碼
InvalidArgument 參數錯誤 400
BadRequest 錯誤請求 400
MissingArgument 缺少參數 400
ImageTooLarge 圖片大小超過限制 400
WatermarkError 浮水印錯誤 400
AccessDenied 拒絕訪問 403
SignatureDoesNotMatch 簽名不匹配 403
NoSuchFile 圖片不存在 404
NoSuchStyle 樣式不存在 404
InternalError 服務內部錯誤 500
NotImplemented 方法未實現 501

處理參數限制說明

目前圖片處理有如下預設限制:

  • 處理源檔案的大小限制在20MB。
  • 縮略操作:對縮略後的圖片的大小有限制,目標縮圖的寬與高的乘積不能超過 4096 * 4096, 而且單邊的長度不能超過 4096 * 4。
  • 旋轉操作:旋轉對圖的尺寸有限制,圖片的寬或者高不能超過4096。
  • 管道目前限制在4個。