百度翻译API签名需用UTF-8原始字节拼接q+app_id+salt+secret_key后MD5；有道API的curtime须为秒级时间戳且参与sign计算；q/input均不可URL编码，HTTP客户端须设超时与重试。
百度翻译 API 的签名生成必须用 UTF-8 原始字节，不是字符串长度
调用百度翻译 API 时最常见的 52001 错误（签名错误）几乎都源于 sign 计算不对。百度要求把 q + app_id + salt + secret_key 拼接后，对**原始 UTF-8 字节**做 MD5，而不是对 Go 字符串调用 len() 或先转成其他编码。
实操要点：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
q必须保持原始 UTF-8 字节（Go 的string本身就是 UTF-8，直接用，别[]byte(q)再转回 string） -
salt推荐用strconv.FormatInt(time.Now().UnixNano(), 10)，避免重复 - 拼接顺序严格为：
q + app_id + salt + secret_key，中间**不加任何分隔符** - MD5 计算用
crypto/md5.Sum([]byte(raw))，再fmt.Sprintf("%x", sum)
示例关键片段：
q := "你好世界"
salt := strconv.FormatInt(time.Now().UnixNano(), 10)
raw := q + appID + salt + secretKey
h := md5.Sum([]byte(raw))
sign := fmt.Sprintf("%x", h)有道翻译 API 的 curtime 是秒级时间戳，且需与 sign 一致
有道要求 curtime 是当前 Unix 时间戳（单位：秒），而很多开发者误用毫秒（time.Now().UnixMilli()），导致返回 108 错误（时间戳无效）。更关键的是：sign 必须用相同的 curtime 参与计算，否则校验失败。
立即学习“go语言免费学习笔记（深入）”；
实操要点：
-
curtime必须是time.Now().Unix()，不是UnixMilli()或UnixNano() -
sign计算公式为：hex(sign.sha256(appKey + input + salt + curtime + secretKey))，其中input是原文 —— 若原文长度 > 20，要用前 10 + 后 10 拼接（有道文档明确要求） - 注意
input在拼接前要 JSON 编码（即双引号包裹、转义），但实际发送请求时仍用原始字符串 - HTTP Header 中必须带
X-App-Key: <appkey></appkey>
中文原文含空格或标点时，百度/有道都要求原样传递，不 URL 编码 q 字段
两个 API 的 q（或 input）参数都要求以 UTF-8 原始字节传输，不能做 url.QueryEscape()。一旦编码，百度会返回 54003（无效签名），有道则可能返回 107（请求参数错误）。
实操要点：
- 构造请求 URL 时，只对非
q/input参数做url.QueryEscape()，比如from、to、appKey -
q直接拼入 URL 查询字符串（如?q=你好世界&from=zh&to=en），由http.Get或http.Post自动处理字节发送 - 若用
http.Client.Do(req)，确保req.URL.RawQuery中的q是未编码的 UTF-8 字节序列
生产环境必须加超时和重试，百度响应慢时容易卡住 goroutine
百度翻译 API 在高负载或跨境网络下，平均响应常达 800ms~2s，且无明确 SLA。用默认 http.DefaultClient 会导致 goroutine 长时间阻塞，尤其在并发调用时迅速耗尽资源。
实操要点：
- 必须自定义
http.Client，设置Timeout: 3 * time.Second和Transport的IdleConnTimeout - 建议加简单重试（最多 1 次），仅针对网络错误或 500/502/503，不要重试 4xx
- 避免在循环里反复 new
http.Client，复用单例 client - 若需高并发，考虑用
semaphore控制并发数（如限制 ≤ 10），防止触发百度频率限制（默认 1QPS 免费版）
容易被忽略的一点：百度返回的 result 是数组（即使单句），解析时得用 []map[string]interface{} 或自定义结构体切片，不是单个对象。
