异常处理

更新时间：2025-08-21

错误处理

GO语言以error类型标识错误，定义了如下两种错误类型：

错误类型	说明
BceClientError	用户操作产生的错误
BceServiceError	ET服务返回的错误

用户使用SDK调用各服务的相关接口，除了返回所需的结果之外还会返回错误，用户可以获取相关错误的详细信息进行处理。实例如下：

Plain Text

1createEtResult, err := etClient.CreateEtDcphy(args)
2if err != nil {
3	switch realErr := err.(type) {
4	case *bce.BceClientError:
5		fmt.Println("client occurs error:", realErr.Error())
6	case *bce.BceServiceError:
7		fmt.Println("service occurs error:", realErr.Error())
8	default:
9		fmt.Println("unknown error:", err)
10	}
11}
12fmt.Println("create et success, etId:", createEtResult.Id)

客户端异常

客户端异常表示客户端尝试向百度云服务发送请求以及数据传输时遇到的异常。例如，当发送请求时网络连接不可用时，则会返回BceClientError；当上传文件时发生IO异常时，也会抛出BceClientError。

服务端异常

当服务端出现异常时，百度云服务端会返回给用户相应的错误信息，以便定位问题。每种服务端的异常需参考各服务的官网文档。

SDK日志

GO SDK自行实现了支持六个级别、三种输出（标准输出、标准错误、文件）、基本格式设置的日志模块，导入路径为github.com/baidubce/bce-sdk-go/util/log。输出为文件时支持设置五种日志滚动方式（不滚动、按天、按小时、按分钟、按大小），此时还需设置输出日志文件的目录。

该日志模块无任何外部依赖，开发者使用GO SDK开发项目，可以直接引用该日志模块自行在项目中使用。可使用GO SDK使用的包级别的日志对象，也可创建新的日志对象，详见如下示例：