什么是错误响应？
当用户访问图片处理服务出现错误的时候，图片处理服务会返回给用户相应的错误码和错误信息，以帮助用户定位与处理问题。
图片处理服务错误的响应格式
错误响应的消息体例子
<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 状态码 |
| TooManyPipe | 管道数目超过限制 | 400 |
| InvalidArgument | 参数错误 | 400 |
| BadRequest | 错误请求 | 400 |
| MissingArgument | 缺少参数 | 400 |
| ImageTooLarge | 图片大小超过限制 | 400 |
| WatermarkError | 水印错误 | 400 |
| AccessDenied | 拒绝访问 | 403 |
| SignatureDoesNotMatch | 签名不匹配 | 403 |
| NoSuchFile | 图片不存在 | 404 |
| NoSuchStyle | 样式不存在 | 404 |
| NoSuchChannel | 频道不存在 | 404 |
| InternalError | 服务内部错误 | 500 |
| NotImplemented | 方法未实现 | 501 |
处理参数限制说明
目前图片处理有如下默认限制：
- 处理源文件的大小限制在20MB。
- 缩略操作：对缩略后的图片的大小有限制，目标缩略图的宽与高的乘积不能超过4096 * 4096， 而且单边的长度不能超过4096 * 4。
- 旋转操作：旋转对图的尺寸有限制，图片的宽或者高不能超过4096。
- 管道目前限制在4个。
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
当您访问图片处理服务遇到错误时，服务会返回一个结构化的错误响应来帮助您定位问题。以下是错误响应的详细说明及常见错误码列表：
错误响应格式示例:
<Error>
<Code>BadRequest</Code>
<Message>Input is not base64 decoding.</Message>
<RequestId>52B155D2D8BD99A15D0005FF</RequestId>
<HostId>userdomain</HostId>
</Error>
错误响应元素说明: - Code: 错误码，标识具体的错误类型。 - Message: 详细错误信息，解释错误的具体原因。 - RequestId: 唯一的请求ID，用于追踪和定位问题。 - HostId: 访问的图片处理服务集群标识。
常见错误码及描述:
- TooManyPipe: 管道数目超过限制，HTTP状态码：400。
- InvalidArgument: 参数错误，HTTP状态码：400。
- BadRequest: 错误请求，HTTP状态码：400。
- MissingArgument: 缺少参数，HTTP状态码：400。
- ImageTooLarge: 图片大小超过限制，HTTP状态码：400。
- WatermarkError: 水印错误，HTTP状态码：400。
- AccessDenied: 拒绝访问，HTTP状态码：403。
- SignatureDoesNotMatch: 签名不匹配，HTTP状态码：403。
- NoSuchFile: 图片不存在，HTTP状态码：404。
- NoSuchStyle: 样式不存在，HTTP状态码：404。
- NoSuchChannel: 频道不存在，HTTP状态码：404。
- InternalError: 服务内部错误，HTTP状态码：500。
- NotImplemented: 方法未实现，HTTP状态码：501。
处理参数限制: - 图片源文件大小限制为20MB。 - 缩略图操作限制：目标缩略图宽与高的乘积不超过4096 * 4096，且单边长度不超过4096像素。 - 旋转操作限制：图片宽度或高度不能超过4096像素。 - 管道数量限制为最多4个。
这些信息有助于您理解错误详情并采取相应的解决措施。如果需要进一步的技术支持，请提供RequestId给图片处理服务团队进行问题定位。
