hmac.New第二个参数必须是[]byte，因Go接口强制类型且隐式转换易引入BOM、空格等不可见字符；签名原文需严格统一method、path、timestamp（秒级）、nonce、body_hash的拼接顺序、编码方式（如url.QueryEscape）及时间戳单位，任一不一致即导致验签失败。
hmac.New 必须传 []byte，不是 string；签名原文拼接顺序、编码方式、时间戳单位三处不一致，验签必失败。
为什么 hmac.New 第二个参数必须是 []byte
Go 的 hmac.New 接口定义为 func New(h func() hash.Hash, key []byte) hash.Hash，第二个参数类型强制为 []byte。传 string 会隐式转成 []byte，看似可行，但若中间经过 string([]byte) 或 fmt.Sprintf 等转换，极易混入不可见字符（如 BOM、换行、空格），导致密钥实际长度或内容与服务端不一致。
- ✅ 正确写法：
hmac.New(sha256.New, []byte(os.Getenv("API_SECRET")))—— 直接从环境变量读取后强转，无中间环节 - ❌ 错误写法：
hmac.New(sha256.New, []byte(string([]byte("x"))))—— 多余转换，可能引入空字符 - ⚠️ 验证建议：在测试时打印
len(key)和fmt.Printf("%q", key)，确认密钥无前后空格、换行或 UTF-8 控制符
签名原文怎么拼才和客户端对得上
“差不多就行”是验签失败的头号原因。服务端和客户端必须用完全相同的字节序列参与 hmac.Write，差一个空格、一个大小写、一个编码方式，hmac.Equal 就返回 false。
- 必须包含字段：
method（全大写，如"GET"）、path（不含 query，如"/api/v1/user"）、timestamp（秒级整数字符串，非毫秒）、nonce（客户端生成的随机字符串）、body_hash（sha256.Sum256(bodyBytes).Sum(nil)后 hex 编码小写） - query 参数不能直接用
req.URL.RawQuery—— 它顺序随机；应调用url.ParseQuery(req.URL.RawQuery)，sort.Strings(keys)后手动拼key=url.QueryEscape(value)，再用&连接 - 所有 value 必须用
url.QueryEscape（不是url.PathEscape，也不是strings.ReplaceAll），空格变%20，而非+ - 常见坑：
X-Signature-Timestamp: "1715234000 "（末尾有空格）、GET /api?uid=123和get /api?uid=123（method 大小写不一致）、JSON body 字段顺序不同导致body_hash不同
验签时只比 sign 值？等于没做
光校验签名字符串相等，防不住重放攻击。攻击者截获一次合法请求，在有效期内反复发送，服务端照样放行。
- 必须校验
timestamp：用time.Now().Unix()对比，拒绝超出 ±300 秒的请求；注意客户端和服务端都用秒级，别混用UnixMilli() - 必须去重
nonce：存到 Redis，key 形如"sig:nonce:" + userID + ":" + nonce，TTL 设为 300 秒；不用 Redis 的话，多实例部署下本地 map 会失效 - 必须过滤签名字段本身：解析 query 或 header 时，提前剔除
sign、signature、X-Signature等字段，否则服务端拼参含它，客户端不含，必然不匹配 - 错误示例：Postman 手动构造请求时自动对 URL 参数二次编码，导致服务端收到的
RawQuery已是 double-encoded，再url.QueryEscape一次就彻底错乱
Gin 中间件里怎么安全读 Body 又不破坏后续绑定
c.Request.Body 是单次读取流，中间件里 io.ReadAll 一次后，后续 c.ShouldBindJSON 就会读到 EOF。
立即学习“go语言免费学习笔记（深入）”；
- 正确流程：先
b, _ := io.ReadAll(c.Request.Body)→ 计算签名 →c.Request.Body = io.NopCloser(bytes.NewReader(b))→ 再调用c.ShouldBindJSON - ⚠️ 切勿使用
c.GetRawData()：它只能调一次，且调完后c.Request.Body不可恢复 - 如果签名不依赖 body（只签 query/header），就完全跳过
Body操作，避免风险 - 务必加保护：用
http.MaxBytesReader限制最大 body 大小，防止恶意 payload 耗尽内存
hmac 函数怎么调，而是哪几个字段该进签名、谁先谁后、每个值 encode 到什么粒度、时间戳用秒还是毫秒、nonce 存哪儿、body 怎么复用——这些细节一旦有一处没对齐，签名就永远算不对。 
