发布：凯铧互联

当用户访问阿里云OSS出现错误时，阿里云OSS会返回给用户相应的错误码和错误信息，便于用户定位问题，并做出适当的处理。

1、阿里云OSS的错误响应格式

当用户访问OSS出错时，OSS会返回给用户一个合适的3xx，4xx或者5xx的HTTP状态码；以及一个application/xml格式的消息体。

错误响应的消息体例子：

<?xml version="1.0" ?>
<Error xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
<Code>
AccessDenied
</Code>
<Message>
Query-string authentication requires the Signature, Expires and OSSAccessKeyId parameters
</Message>
<RequestId>
1D842BC5425544BB
</RequestId>
<HostId>
oss-cn-hangzhou.aliyuncs.com
</HostId>
</Error>
2、所有错误的消息体中都包括以下几个元素：

Code：OSS返回给用户的错误码。
Message：OSS给出的详细错误信息。
RequestId：用于唯一标识该次请求的UUID；当你无法解决问题时，可以凭这个RequestId来请求OSS开发工程师的帮助。
HostId：用于标识访问的OSS集群，与用户请求时使用的Host一致。
其他特殊的错误信息元素请参照每个请求的具体介绍。

3、OSS的错误码

OSS的错误码列表如下：

错误码	描述	HTTP状态码	说明
AccessDenied	拒绝访问	403	原因及排除请参看OSS权限问题及排查
BucketAlreadyExists	Bucket已经存在	409	CreateBucket指定的BucketName已经使用，请选择新的BucketName
BucketNotEmpty	Bucket不为空	409	DeleteBucket前请先删除文件和未完成的分片上传任务
CallbackFailed	上传回调失败	203	原因及排除请参看上传回调错误及排除
EntityTooLarge	实体过大	400	Post请求消息长度超过 5GB，原因及排除请参看PostObject错误及排查
EntityTooSmall	实体过小	400	Post请求消息长度太短，排除请参看PostObject错误及排查
FieldItemTooLong	Post请求中表单域过大	400	除了file的表单域大小不要超过4KB，排除请参看PostObject错误及排查
FilePartInterity	文件Part已改变	400	读分片数据时发现数据与校验和不符
FilePartNotExist	文件Part不存在	400	CompleteMultipartUpload提交的分片没有上传
FilePartStale	文件Part过时	400	读分片数据时发现数据与长度不符
IncorrectNumberOfFilesInPOSTRequest	Post请求中文件个数非法	400	Post请求表单域中只能有一个file域，排除请参看PostObject错误及排查
InvalidArgument	参数格式错误	400	参数格式不符合要求，请对照相应API
InvalidAccessKeyId	AccessKeyId不存在	403	AccessKeyId无效或过期，排除请参看403错误及排查
InvalidBucketName	无效的Bucket名字	400	Bucket命名规则请参看开发人员指南
InvalidDigest	无效的摘要	400	指定的MD5校验值与文件不符，MD5的计算方法请参见PutObject
InvalidEncryptionAlgorithmError	指定的熵编码加密算法错误	400	目前只支持AES256加密算法，详见PutObject
InvalidObjectName	无效的Object名字	400	ObjectName命名规则请参看开发人员指南
InvalidPart	无效的Part	400	CompleteMultipartUpload提交的Part无效，PartNumber或ETag错误
InvalidPartOrder	无效的part顺序	400	CompleteMultipartUpload提交的Part需按照PartNumber升序排列
InvalidPolicyDocument	无效的Policy文档	400	Post请求中Policy无效，排除请参看PostObject错误及排查
InvalidTargetBucketForLogging	Logging操作中有无效的目标bucket	400	存放Logging的目标bucket不存在，请更换
InternalError	OSS内部发生错误	500	请重试
MalformedXML	XML格式非法	400	请求中XML非法，请根据具体请求排除DeleteObjects、CompleteMultipartUpload、PutBucketLogging、PutBucketWebsite、PutBucketLifecycle、PutBucketReferer、PutBucketCORS
MalformedPOSTRequest	Post请求的body格式非法	400	表单域格式非法，排除请参看PostObject错误及排查
MaxPOSTPreDataLengthExceededError	Post请求上传文件内容之外的body过大	400	除了file的表单域大小不要超过4KB，排除请参看PostObject错误及排查
MethodNotAllowed	不支持的方法	405	以OSS不支持的操作来访问资源
MissingArgument	缺少参数	411	请参看具体的API对照解决
MissingContentLength	缺少内容长度	411	消息即非chunked encoding又没有携带Content-Length
NoSuchBucket	Bucket不存在	404	这个提示没什么可说的，请少侠传数据
NoSuchKey	Object不存在	404	这个提示没什么可说的，请少侠传数据
NoSuchUpload	Multipart Upload ID不存在	404	没有初始化分片上传或者初始化的分片上传过期
NotImplemented	无法处理的方法	400	OSS不支持的操作
ObjectNotAppendable	不是可追加文件	409	OSS有三类文件normal、appendable、multipart，只有appendable类型的文件才能执行AppendObject
PositionNotEqualToLength	Append的位置和文件长度不相等	409	详见AppendObject
PreconditionFailed	预处理错误	412	下载条件不符合，详见GetObject
RequestTimeTooSkewed	发起请求的时间和服务器时间超出15分钟	403	排除请参看403错误及排查
RequestTimeout	请求超时	400	请重试
RequestIsNotMultiPartContent	Post请求content-type非法	400	排除请参看PostObject错误及排查
DownloadTrafficRateLimitExceeded	下载流量超过限制	503	默认上限是 5Gbps，包括内外网，有调整需求请提交工单
UploadTrafficRateLimitExceeded	上传流量超过限制	503	默认上限是 5Gbps，包括内外网，有调整需求请提交工单
SignatureDoesNotMatch	签名错误	403	排除请参看Header中签名、URL中签名
TooManyBuckets	Bucket数目超过限制	400	默认上限是 10，有调整需求请提交工单

以上就是关于阿里云OSS错误响应格式及错误码的说明。阿里云代理商凯铧互联提供阿里云服务器/企业邮箱等产品的代购服务，同样的品质，更多贴心的服务，更实惠的价格。 阿里云代理商凯铧互联会为您提供一对一专业全面的技术服务，同时还能为您提供阿里云其他产品购买的专属折扣优惠。通过凯铧互联购买可以获得折上折优惠！若您需要帮助可以直接联系我方客服，阿里云代理商凯铧互联专业技术团队为您提供全面便捷专业的7x24技术服务。 电话专线：136-5130-9831，QQ:3398234753。

为什么选择我们：北京凯铧互联科技有限公司（简称凯铧互联）由多名前阿里云资深技术专家创立,核心员工来自阿里云、腾讯云等,作为阿里云,腾讯云百度云,金山云,华为云重要的合作伙伴,专注于为企业用户提供云计算及云计算的解决方案。总部设在北京,并在内蒙设有办事处。做为一家综合性方案商,凯铧互联向各行业用户提供基于云计算的各种解决方案。为用户获得优质服务的同时,秉承"专业规划、周到服务"的服务理念,根据用户的实际情况,充分考虑各种网络资源的特点及功效,为用户量身定做一套适合于其实际应用需求的网络应用方案。帮助用户利用互联网的力量展开新的营销方式,并大大缩短了项目实施周期,获得用户的一致好评。