tencent cloud

数据万象

动态与公告
产品动态
产品公告
产品简介
产品概述
产品优势
应用场景
功能概览
地域与域名
使用限制
产品计费
计费概述
计费方式
计费项
免费额度
欠费说明
查看消费明细
常见问题
快速入门
注册与登录
绑定存储桶
上传和处理文件
下载和删除文件
解绑存储桶
通过 COS 使用数据万象
能力地图
图片处理
媒体处理
内容审核
AI 内容识别
文档处理
智能语音
文件处理
用户指南
概览
存储桶管理
智能工具箱
任务与工作流
数据监控
用量统计
实践教程
版权保护解决方案
图片处理实践
API 授权策略使用指引
工作流实践
API 文档
API 概览
结构体
公共请求头部
公共响应头部
开通万象服务
图片处理
AI 内容识别
智能语音
媒体处理
内容审核
文档处理
文件处理
任务与工作流
云查毒
错误码
请求签名
SDK 文档
SDK 概览
图片处理 Android SDK
图片处理 iOS SDK
COS Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Go SDK
COS iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
小程序 SDK
SDK 产品个人信息保护规则
安全与合规
权限管理
常见问题
基础设置
文档处理
媒体处理
内容识别
智能语音
服务协议
Service Level Agreement
联系我们
词汇表

异常处理

PDF
聚焦模式
字号
最后更新时间: 2024-03-13 10:07:11

简介

调用 SDK 请求对象存储(Cloud Object Storage,COS)或数据万象(Cloud Infinite,CI)服务失败时,抛出的异常皆是 RuntimeExcpetion。 目前 SDK 常见的异常有 CosClientException,CosServiceException,CIServiceException 和 IllegalArgumentException。

客户端异常

CosClientException 是由于客户端无法和服务端完成正常的交互而导致的失败。例如客户端无法连接到服务端,无法解析服务端返回的数据,读取本地文件发生 IO 异常等。CosClientException 继承自 RuntimeException,没有自定义的成员变量,使用方法同 RuntimeException。

服务端异常

CosServiceException 和 CIServiceException 用于指交互正常完成,但是操作失败的场景。例如客户端访问一个不存在 Bucket,删除一个不存在的文件,没有权限进行某个操作,服务端故障异常等。 CosServiceException 包含了服务端返回的状态码,requestid,出错明细等。捕获异常后,建议对整个异常进行打印,异常包含了必须的排查因素。以下是异常成员变量的描述:
request 成员
描述
类型
requestId
请求 ID,用于表示一个请求,对于排查问题十分重要
String
traceId
辅助排查问题的 ID
String
statusCode
response 的 status 状态码,4xx 是指请求因客户端而失败,5xx 是服务端异常导致的失败。请参见 COS 错误码
String
errorType
枚举类,表示异常的种类,分为 Client,Service,Unknown
ErrorType
errorCode
请求失败时 body 返回的 Error Code 请参见 COS 错误码
String
errorMessage
请求失败时 body 返回的 Error Message 请参见 COS 错误码
String

使用自助诊断工具

针对请求可能遇到不同的报错情况,我们为您提供了 CI 自助诊断工具,帮助您快速定位问题,调试报错代码。

使用步骤

1. 复制异常处理返回的 RequestId(请求 ID)。
2. 单击 CI 自助诊断工具,进入自助诊断页面。

3. 在顶部的 RequestId 输入框中,输入待诊断的 RequestId,并单击开始诊断
4. 稍侯片刻,便能看到相应的智能诊断结果。

常见问题

若您在使用 Java SDK 过程中,有相关的疑问,请参见 常见问题 文档。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈