签名原文拼接必须严格固定字段顺序和编码方式，服务端验签失败90%因客户端与服务端signingString不一致；须按HTTP方法、URI路径（r.URL.EscapedPath()）、X-Timestamp（秒级）、X-Nonce、标准化query（字典序+url.PathEscape）、body hash顺序拼接，字段间用\n分隔，禁用url.Values.Encode，body须用io.ReadAll读原始字节。
签名原文拼接必须严格固定字段顺序和编码方式
服务端验签失败，90% 是因为客户端拼的 signingString 和服务端还原的不一致。不是算法错了，是字符串本身对不上。
关键点：HTTP 方法、URI 路径（用 r.URL.EscapedPath()，不是 r.URL.Path）、X-Timestamp 值（秒级，time.Now().Unix()）、X-Nonce 值、标准化后的 query 字符串、body hash（若存在），这六项缺一不可，顺序也不能调换。
- query 必须从
r.URL.RawQuery解析，手动排序键名（字典序），每个 value 先url.PathEscape再拼接，禁用url.Values.Encode()—— 它会自动加空格、打乱顺序、忽略重复 key - body hash 一定要基于原始字节算：
bodyBytes, _ := io.ReadAll(r.Body)，之后再用bytes.NewReader(bodyBytes)供后续逻辑读取；别在json.Unmarshal后拼字符串再 hash - 所有字段之间统一用
\n分隔（不是&或空格），末尾不加换行，大小写全小写（如post不是POST）
hmac.New 的密钥和哈希构造器不能传错
常见 panic 或签名恒定不变，往往是因为 hmac.New 第二个参数传了错误类型——它要的是 []byte 密钥，不是 string，也不是已计算好的 hash 实例。
- 密钥必须从环境变量或 Vault 加载，长度 ≥32 字节；
os.Getenv("API_SECRET")后直接转[]byte，别中间多一次string()转换（尤其含非 ASCII 字符时会静默损坏） - 第一个参数必须是哈希函数构造器，比如
sha256.New，不是sha256.New()（带括号就是实例，会编译报错） - 每次签名都要新建
hmac.Hash，别缓存复用——它不是线程安全的，高并发下会串值 - 算完必须用
h.Sum(nil)拿结果，h.Sum([]byte{})也行，但绝不能直接读h.Sum字段（那是内部缓冲区）
验签前必须做三重校验：时间戳、nonce、签名值
只比对 X-Signature 等于就放行，等于没签名。攻击者截包重放一次就能无限刷。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 时间戳校验用
abs(reqTime - time.Now().Unix()) > 300（±5 分钟），注意两端都用 UTC 时间；别混用time.Now().Unix()和time.Now().In(loc).Unix() - nonce 必须 Redis SETEX 300 秒去重，不能用内存 map —— 多实例部署时失效；value 可设为任意占位符（如
"1"），只要能判断是否存在 - 签名比对必须用
hmac.Equal(sig1, sig2)，不是==—— 否则可能被时序攻击绕过；该函数在 Go 1.3+ 标准库中可用，低于此版本需升级 - 额外防御：检查
X-Timestamp是否纯数字字符串，防止传"1716710400abc"导致strconv.ParseIntpanic
Header 字段名和服务端约定必须字面一致
看似小问题，却常导致 401 却查不出原因。HTTP header 名虽不区分大小写，但网关、SDK、中间件可能严格匹配。
- 确认服务端实际读取的 header 名：是
X-Signature、X-Hub-Signature-256，还是Authorization: HMAC-SHA256 xxx？抓包看真实请求头，别信文档示例 - 如果要求复合格式（如
HMAC-SHA256 xxxxx），注意中间是短横线，不是下划线或空格；签名值统一用小写 hex，避免 base64 或大写 - 所有自定义 header 都建议首字母大写驼峰（
X-Timestamp），避免x-timestamp被某些网关过滤或改写 - Nginx 或 API 网关可能自动解码 query、重写 path、吞掉 header；若发现验签总失败，先关掉中间件直连服务端定位
最易被忽略的是 body 读取时机和 query 归一化——它们不在签名逻辑里显眼，却决定整个链路是否可靠。一次 req.Body 读完就没法再读，而 r.URL.RawQuery 和 r.URL.EscapedPath() 这两个方法的名字本身就容易让人选错。
