阿里云Go SDK需按服务选择：新服务（如DocMind、FC OpenAPI、SchedulerX、NLS）必须用alibabacloud-go系列Darabonba SDK，旧服务可用aliyun/alibaba-cloud-sdk-go；混用会报错或404；凭证须通过credentials-go统一管理，异步接口需显式设超时（≥60000ms），SchedulerX任务名须与控制台完全一致。
github.com/aliyun/alibaba-cloud-sdk-go 是最通用的方式，但**它不支持文档智能、SchedulerX、FC OpenAPI 等新服务**——这些必须用阿里云新版 Darabonba SDK（即 github.com/alibabacloud-go/xxx 系列）。
老 SDK 和新 SDK 不兼容，混用会报错；选错会导致编译通过但运行时 404 Not Found 或 InvalidAccessKeyId。关键不是“能不能调”，而是“调哪个服务、用哪套 SDK”。
确认你要调的服务是否在新版 SDK 覆盖范围内
阿里云从 2022 年起逐步将新服务（如 DocMind、FC OpenAPI、SchedulerX、NLS）迁出老 SDK，统一由 Darabonba 代码生成器维护：
- 文档智能（DocMind）→ 必须用
github.com/alibabacloud-go/docmind-api-20220711 - 函数计算 HTTP 触发器（FC OpenAPI）→ 必须用
github.com/alibabacloud-go/fc-open-20210406 - 分布式任务调度（SchedulerX）→ 必须用
github.com/alibaba/schedulerx-worker-go（注意：这不是 Darabonba 生成的，是独立 worker SDK） - 语音识别（NLS）→ 必须用
github.com/aliyun/alibabacloud-nls-go-sdk - AIRec、旧版 ECS/SLB/OSS 等 → 可继续用
github.com/aliyun/alibaba-cloud-sdk-go
查不到对应包？去 阿里云 SDK 文档中心 搜索服务名 + “Go SDK”，点进最新版文档，看「安装」章节给的 go get 命令——别抄错 tag 或分支。
身份认证不能硬编码 AccessKey
所有新版 SDK 都依赖 github.com/aliyun/credentials-go 统一管理凭证，但直接写死 AccessKeyId 和 AccessKeySecret 在代码里等于裸奔：
- 哪怕只在本地测试，也建议用环境变量：
ALIBABA_CLOUD_ACCESS_KEY_ID/ALIBABA_CLOUD_ACCESS_KEY_SECRET - 生产环境优先走配置文件（
~/.alibabacloud/credentials），或 RAM 角色 + STS 临时 Token（尤其在 ACK/ECS 上运行时） - 用
credentials.NewCredential()初始化后传给 SDK config，不要手动 set 字段——否则部分 SDK（如 DocMind）会忽略你设的 credential
示例（FC OpenAPI）：
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
ak := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
sk := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
cred, _ := credentials.NewCredential(&credentials.Config{
Type: "access_key",
AccessKeyId: ak,
AccessKeySecret: sk,
})
config := &openapi.Config{Credential: cred}
config.SetRegionId("cn-hangzhou")
client, _ := fcopen.NewClient(config)
异步任务（如 DocMind 提交）要设超时，否则卡死
文档智能类接口本质是异步轮询，提交后返回 TaskId，再查结果。但默认 HTTP 超时只有 10 秒，大文件上传或网络抖动时直接 context deadline exceeded：
-
ConnectTimeout和ReadTimeout必须显式设为 60000（毫秒）及以上 - 如果用本地文件上传（
SubmitDocProcessTaskRequest），SDK 内部会自动 multipart 上传，但超时不改照样失败 - 别信文档里写的“默认 30 秒”——实际底层 client 默认是 10 秒，且新版 SDK 不继承老 client 的 timeout 设置
正确写法（DocMind）：
config := &openapi.Config{...}
connectTimeout := 60000
readTimeout := 60000
config.ConnectTimeout = &connectTimeout
config.ReadTimeout = &readTimeout
SchedulerX Worker 注册任务名必须和控制台完全一致
schedulerx-worker-go 是长连接保活型 SDK，不是一次性的 HTTP client。注册任务时名字错一个字符、大小写不对、多空格，控制台就永远看不到该任务执行日志：
- 控制台创建任务时填的“任务名称”字段，就是
client.RegisterTask("xxx", task)的第一个参数 - 不支持通配符、正则、模糊匹配——纯字符串精确比对
- 如果你用的是分组（
GroupId）+ 命名空间（Namespace），三者必须和控制台应用配置页显示的一致，缺一不可 - 调试时加一行
fmt.Printf("registering task: %s\n", name)，和控制台截图逐字对比
容易被忽略的是：控制台里“任务类型”选的是 “Go” 还是 “Shell”？选错类型，Worker 根本不会拉取这个任务。
