签名原文拼接必须严格固定字段顺序和编码方式，服务端验签失败90%因signingString不一致；须按method、path（EscapedPath）、timestamp（秒级）、nonce、sortedQuery（字典序+PathEscape）、bodyHash顺序用\n拼接，末尾无换行。
签名原文拼接必须严格固定字段顺序和编码方式
服务端验签失败，90% 是因为客户端和服务端拼出的 signingString 不一致——不是 HMAC 写错了，是字符串本身对不上。关键字段缺一不可、顺序不能调换、分隔符必须统一为 \n：
-
method：全小写，如get或post，别用r.Method直接拼，要转小写 -
path：必须用r.URL.EscapedPath()，不是r.URL.Path（后者已被自动 decode，中文/特殊字符会乱） -
timestamp：秒级时间戳（time.Now().Unix()），毫秒级容易导致窗口校验不一致；注意客户端和服务端都用 UTC -
nonce：16 字节随机串，用crypto/rand.Read()生成后 hex 编码，明文传参 -
sortedQuery：从r.URL.RawQuery解析，url.ParseQuery()→sort.Strings(keys)→ 每个key和value单独调用url.PathEscape()（不是url.QueryEscape()，后者把空格转成+）→ 拼成key1=value1&key2=value2 -
bodyHash：若接口有 body，必须先io.ReadAll(r.Body)得到原始字节，再用sha256.Sum256(bodyBytes).Sum(nil)算 hash；之后用bytes.NewReader(bodyBytes)重建Body供后续逻辑读取
最终拼接格式：method + "\n" + path + "\n" + timestamp + "\n" + nonce + "\n" + sortedQuery + "\n" + bodyHashHex，末尾不加换行，所有字段之间仅一个 \n。
hmac.New 的密钥和哈希构造器传参必须精准
八成签名恒定不变或 signature mismatch，源于 hmac.New 参数类型错位：
- 第一个参数必须是哈希构造器函数，如
sha256.New（不带括号）；写成sha256.New()会编译报错 - 第二个参数必须是原始
[]byte，不能是中间多转一次的string或未解码的密钥字符串 - 如果密钥配置为 base64 字符串（如
"aGVsbG8="），启动时必须用base64.StdEncoding.DecodeString(secret)一次性解码并缓存 - 如果密钥是 hex 字符串（如
"deadbeef"），用hex.DecodeString(secret) - 绝不能写成
[]byte(string([]byte(secret)))——非 ASCII 字符会静默损坏；调试时打印len(key)和fmt.Printf("%q", key)，确认无 BOM、首尾空格或不可见字符
验签前必须做三重校验，少一项等于没防
只比对 hmac.Equal(sig1, sig2) 是最大误区。攻击者截包重放，只要签名值还有效，就能绕过业务逻辑：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
-
时间戳校验：检查
X-Timestamp是否为纯数字字符串，再用abs(reqTime - time.Now().Unix()) > 300判是否超 ±5 分钟；注意两端单位必须一致（别混用Unix()和UnixMilli()） -
nonce 去重：Redis 中 SETEX
"api:nonce:" + fmt.Sprintf("%d:%s", ts, nonce)，TTL 设为 300 秒（窗口时长）+ 3 秒冗余；不能用内存 map，多实例部署时失效 -
签名比对：必须用
hmac.Equal(sig1, sig2)，不是==——否则可能被时序攻击利用
这三步必须在验签函数里顺序执行，任一失败立即返回 401，且不暴露具体失败原因（避免信息泄露）。
框架中间件中如何安全读取并复用 request.Body
Go 的 r.Body 只能读一次，但验签需要原始字节，业务逻辑又需要解析 JSON 或 form-data。常见错误是多次 io.ReadAll 导致后续读不到内容：
- 在中间件开头就执行
bodyBytes, _ := io.ReadAll(r.Body)，然后立即用r.Body = io.NopCloser(bytes.NewReader(bodyBytes))恢复可读性 - 不要依赖框架自动 binding（如 Gin 的
c.ShouldBindJSON()），它会内部调用r.Body，破坏原始流 - 若用 Gin/Echo，禁用自动 form binding，改用
c.GetRawData()或手动json.Unmarshal(bodyBytes, &v) - 调试时建议直接打印
string(bodyBytes)和完整signingString，比只看最终 signature 更容易定位拼接问题
复杂点在于：不同 HTTP 方法（GET/POST）、不同 Content-Type（application/json / application/x-www-form-urlencoded）、不同网关（Nginx 自动解码 query）都会干扰原始数据形态——你得在 handler 最入口处就完成归一化，而不是等进到业务层才处理。
