百度翻译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() 或先转成其他编码。
实操要点:
-
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 参与计算,否则校验失败。
实操要点:
-
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:
中文原文含空格或标点时,百度/有道都要求原样传递,不 URL 编码 q 字段
两个 API 的 q(或 input)参数都要求以 UTF-8 原始字节传输,不能做 url.QueryEscape()。一旦编码,百度会返回 54003(无效签名),有道则可能返回 107(请求参数错误)。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
实操要点:
- 构造请求 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{} 或自定义结构体切片,不是单个对象。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










