必须动态获取并缓存access_token，用resty.SetFormData请求/oauth/2.0/token；传图需Base64编码且≤2MB，image_type须大写；复用resty.Client并配置连接池；face_list须判空遍历，勿默认取[0]。
用 resty 调百度 AI 人脸检测接口，access_token 必须动态获取
百度 AI 所有 v3 接口（如 /face/v3/detect）都强制校验 access_token，它不是固定密钥，有效期仅 30 天，且每次调用需拼在 URL 里。硬编码或手动填 token 会导致 2 小时后批量失败。
-
access_token获取必须走https://aip.baidubce.com/oauth/2.0/tokenPOST 请求，传grant_type=client_credentials、client_id（即 API Key）、client_secret（即 Secret Key） - 建议封装成
getAccessToken()函数，首次调用缓存结果 + 记录过期时间戳，后续请求前先判断是否剩余600秒（10 分钟），不足则刷新 - 别用
net/http手动拼 body ——resty的.SetFormData()更安全，自动处理Content-Type: application/x-www-form-urlencoded
FaceSearch 传图必须是 Base64 或二进制，不能直接传本地路径
常见错误是写 face.NewImageFromFile("path/to/face.jpg") 后直接塞给 client.FaceSearch()，但百度 API 根本不认文件路径 —— 它只接受 image 字段为 Base64 编码字符串，或 image_type 设为 url 并提供公网可访问链接。
- 读图后必须用
base64.StdEncoding.EncodeToString(buf)转码，且注意去掉换行符（strings.ReplaceAll(..., "\n", "")） -
image_type值只能是"BASE64"、"URL"或"FACE_TOKEN"（后者需先调detect拿到 token）；写成小写"base64"会返回error_code: 216000 - 图片大小限制严格：Base64 编码后不能超 2MB，否则报
error_code: 216100；建议提前用golang.org/x/image/draw缩放至宽高 ≤ 1920px
并发调用时，resty.Client 要复用，别在循环里反复 resty.New()
很多人在批量识别人脸时，对每张图都新建一个 resty.Client，导致文件描述符暴涨、DNS 解析卡顿，甚至触发百度限流（error_code: 18）。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 全局声明一个
var client = resty.New().SetTimeout(10 * time.Second)，并设置.SetRetryCount(2)应对临时网络抖动 - 百度 QPS 限制默认是 5，超过会返回
error_code: 17；若需更高频，得去控制台申请配额，不能靠加 goroutine 硬扛 - 注意 HTTP 连接复用：启用
.SetTransport(&http.Transport{MaxIdleConns: 100, MaxIdleConnsPerHost: 100})，否则默认 2 连接会成为瓶颈
返回的 result.face_list 是切片，但单图可能含多张脸，别默认取 [0]
开发时用单人正脸图测试一切正常，上线后遇到合影就 panic —— 因为 result.FaceList 是 []FaceItem，而业务代码直接写 result.FaceList[0].FaceToken，没判空也没遍历。
立即学习“go语言免费学习笔记（深入）”；
- 务必检查
len(result.FaceList) == 0，此时说明没检出人脸，不是 API 错误，而是图像质量或角度问题 - 若需找“最正”的脸，按
face.Location.Rotation和face.Location.Yaw过滤（理想值接近 0），而非简单取第一个 -
face.Score是置信度（0~100），低于 80 通常不可信；百度不返回人脸坐标原图比例，Location中的X/Y是相对图宽高的归一化值，需乘原图尺寸才得像素坐标
真正麻烦的从来不是调通 API，而是百度返回的 error_code 文档藏得深、字段含义模糊，比如 222200 是“图片中未检测到人脸”，但和 216100（图片过大）错误码长得太像，容易看串。
