当用户访问图片处理服务出现错误的时候，图片处理服务会返回给用户相应的错误码和错误信息，以帮助用户定位与处理问题。

图片处理服务错误的响应格式

错误响应的消息体例子：

<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个。

SDK 示例