Java-SDK - 异常处理
调用OSSClient类的相关接口时，[backcolor=transparent]如果抛出异常，则表明操作失败，否则操作成功。抛出异常时，方法返回的数据无效。OSS Java SDK包含两类异常，一类是服务器端异常OSSException，另一类是客户端异常ClientException，它们均继承自RuntimeException。
异常处理示例
try {// Do some operations with the instance here, such as put object...client.putObject(...);} catch (OSSException oe) {System.out.println("Caught an OSSException, which means your request made it to OSS, "+ "but was rejected with an error response for some reason.");System.out.println("Error Message: " + oe.getErrorCode());System.out.println("Error Code: " + oe.getErrorCode());System.out.println("Request ID: " + oe.getRequestId());System.out.println("Host ID: " + oe.getHostId());} catch (ClientException ce) {System.out.println("Caught an ClientException, which means the client encountered "+ "a serious internal problem while trying to communicate with OSS, "+ "such as not being able to access the network.");System.out.println("Error Message: " + ce.getMessage());} finally {if (client != null) {client.shutdown();}}
ClientException
ClientException表示客户端尝试向OSS发送请求以及数据传输时遇到的异常。例如，当发送请求时网络连接不可用时，则会抛出 ClientException；当上传文件时发生IO异常时，也会抛出ClientException。
OSSException
OSSException指服务器端错误，它来自于对服务器错误信息的解析，包含OSS会返回给用户相应的错误码和错误信息，便于用户定位问题，并做出适当的处理。
OSSException通常包含以下错误信息：
- Code： OSS返回给用户的错误码。
- Message： OSS提供的详细错误信息。
- RequestId： 用于唯一标识该请求的UUID；当您无法解决问题时，可以凭这个RequestId来请求OSS开发工程师的帮助。
- HostId： 用于标识访问的OSS集群，与用户请求时使用的Host一致。
OSS常见错误码
| 错误码 | 描述 | HTTP状态码 |
| AccessDenied | 拒绝访问 | 403 |
| BucketAlreadyExists | Bucket已经存在 | 409 |
| BucketNotEmpty | Bucket不为空 | 409 |
| EntityTooLarge | 实体过大 | 400 |
| EntityTooSmall | 实体过小 | 400 |
| FileGroupTooLarge | 文件组过大 | 400 |
| FilePartNotExist | 文件Part不存在 | 400 |
| FilePartStale | 文件Part过时 | 400 |
| InvalidArgument | 参数格式错误 | 400 |
| InvalidAccessKeyId | AccessKeyId不存在 | 403 |
| InvalidBucketName | 无效的Bucket名字 | 400 |
| InvalidDigest | 无效的摘要 | 400 |
| InvalidObjectName | 无效的Object名字 | 400 |
| InvalidPart | 无效的Part | 400 |
| InvalidPartOrder | 无效的part顺序 | 400 |
| InvalidTargetBucketForLogging | Logging操作中有无效的目标bucket | 400 |
| InternalError | OSS内部发生错误 | 500 |
| MalformedXML | XML格式非法 | 400 |
| MethodNotAllowed | 不支持的方法 | 405 |
| MissingArgument | 缺少参数 | 411 |
| MissingContentLength | 缺少内容长度 | 411 |
| NoSuchBucket | Bucket不存在 | 404 |
| NoSuchKey | 文件不存在 | 404 |
| NoSuchUpload | Multipart Upload ID不存在 | 404 |
| NotImplemented | 无法处理的方法 | 501 |
| PreconditionFailed | 预处理错误 | 412 |
| RequestTimeTooSkewed | 发起请求的时间和服务器时间超出15分钟 | 403 |
| RequestTimeout | 请求超时 | 400 |
| SignatureDoesNotMatch | 签名错误 | 403 |
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
在使用阿里云对象存储服务（OSS）的Java SDK进行操作时，正确处理异常对于确保程序健壮性和理解错误原因至关重要。根据您提供的信息，这里是对两类异常及其处理方式的总结：
1. ClientException（客户端异常）
- 描述：这类异常发生在客户端尝试与OSS服务器通信时遇到问题，比如网络连接问题、本地I/O错误等。
- 示例场景：网络不可达、文件读写失败等。
- 处理建议：通常需要检查客户端的网络配置、权限设置、输入输出操作是否正确。
2. OSSException（服务器端异常）
- 描述：当OSS服务器接收到请求但无法成功处理时抛出，包含具体的错误码和错误信息，便于定位问题。
- 包含信息：
Code：OSS返回的错误码，如AccessDenied表示访问被拒绝。Message：详细的错误描述。RequestId：唯一标识请求的ID，用于寻求技术支持。HostId：标识访问的OSS集群。
-
示例错误码：
AccessDenied：403，表明没有足够的权限访问资源。BucketAlreadyExists：409，尝试创建已存在的Bucket。NoSuchBucket：404，指定的Bucket不存在。
-
处理建议：根据错误码和消息调整请求参数或检查相关资源的配置。例如，如果遇到
AccessDenied，应检查访问密钥是否正确，以及是否有相应的访问策略。
异常处理示例代码回顾
try {
// 执行OSS操作，如上传文件
client.putObject(...);
} catch (OSSException oe) {
// 处理OSS服务器端异常
System.out.println("Error Message: " + oe.getErrorCode());
// 记录或处理其他详细信息如RequestId, HostId等
} catch (ClientException ce) {
// 处理客户端异常，如网络问题
System.out.println("Error Message: " + ce.getMessage());
} finally {
// 确保OSSClient关闭以释放资源
if (client != null) {
client.shutdown();
}
}
通过上述异常处理机制，开发者可以有效地识别并响应在使用OSS过程中可能遇到的各种错误情况，从而提升应用的稳定性和用户体验。
