客户端初始化最佳实践（Go）

核心规则

• - 客户端是协程安全的 — 可在多个协程间安全共享，无需额外同步。
• 使用单例模式 — 不要为每个请求创建新的客户端实例。频繁创建客户端会浪费资源。
• 优先使用显式端点，而非基于区域的端点解析。

推荐的客户端创建方式

go
import (
os
sync

openapi github.com/alibabacloud-go/darabonba-openapi/v2/client
ecs github.com/alibabacloud-go/ecs-20140526/v3/client
github.com/alibabacloud-go/tea/tea
)

var (
ecsClient *ecs.Client
ecsClientOnce sync.Once
)

func GetEcsClient() *ecs.Client {
ecsClientOnce.Do(func() {
config := &openapi.Config{
AccessKeyId: tea.String(os.Getenv(ALIBABACLOUDACCESSKEYID)),
AccessKeySecret: tea.String(os.Getenv(ALIBABACLOUDACCESSKEYSECRET)),
Endpoint: tea.String(ecs.cn-hangzhou.aliyuncs.com),
}
var err error
ecsClient, err = ecs.NewClient(config)
if err != nil {
panic(err)
}
})
return ecsClient
}

端点配置

优先级：显式 Endpoint > 通过 RegionId 进行区域解析。

go
// 推荐：显式端点
config.Endpoint = tea.String(ecs.cn-hangzhou.aliyuncs.com)

// 备选：SDK 从区域解析端点
config.RegionId = tea.String(cn-hangzhou)

VPC 端点

在阿里云 VPC 内部运行时使用 VPC 端点：

go
config.Endpoint = tea.String(ecs-vpc.cn-hangzhou.aliyuncs.com)

文件上传 API（高级版）

为文件上传 API 设置同时设置 RegionId 和 Endpoint 为同一区域：

go
config.RegionId = tea.String(cn-shanghai)
config.Endpoint = tea.String(objectdet.cn-shanghai.aliyuncs.com)
// VPC 文件上传授权：
client.OpenPlatformEndpoint = tea.String(openplatform-vpc.cn-shanghai.aliyuncs.com)
client.EndpointType = tea.String(internal)

SDK 组件

调试

通过环境变量启用调试模式以记录所有请求：

bash
export DEBUG=tea