签名验证必须在HTTP中间件中统一实现，不能置于业务handler内，否则会绕过前置安全检查；需用io.ReadAll读取并重置r.Body以供后续使用，严格校验时间戳（±300秒）、nonce去重及body SHA256，签名原文须按方法+路径+时间戳+随机串+body哈希拼接，密钥从环境变量加载，结果用base64.StdEncoding编解码。
签名验证必须在 HTTP 中间件里做，不能放业务逻辑里
签名验证是请求进入服务后的第一道防线，如果放到 handler 里再校验，意味着请求已绕过身份前置检查、可能触发日志记录、甚至调用下游——伪造请求已经“走了一半流程”。Go 的 http.Handler 中间件（如用 func(http.Handler) http.Handler 包裹）能确保所有路径统一拦截，且可提前 abort 请求。
常见错误是把签名校验写在某个具体 API 的 handler 内部，导致部分接口漏校验，或不同 handler 复制粘贴校验逻辑，后续算法更新时容易遗漏。
- 所有入口路由必须经过同一中间件，比如
signatureMiddleware - 中间件中调用
r.Body前需用io.ReadAll读取并重置r.Body，否则后续 handler 读不到 body - 签名头字段名要统一约定（如
X-Signature、X-Timestamp、X-Nonce），避免大小写混淆（HTTP header 是 case-insensitive，但 Go 的r.Header.Get()对键名不敏感，实际取值没问题）
签名生成必须包含时间戳、随机串、body SHA256，缺一不可
只对参数排序哈希（比如拼 query string）极易被重放；只签 URL 不签 body 会被篡改 payload；不带时间戳就无法做时效性判断。标准做法是构造一个确定性字符串：方法 + 路径 + 时间戳 + 随机串 + body SHA256（空 body 也参与计算，用空字符串哈希），再用私钥 HMAC-SHA256 签名。
注意：body 必须在签名前完整读取一次，且不能依赖 r.FormValue 或 r.ParseForm() —— 这些会自动解析并消耗 body，且对 multipart/form-data 等格式行为不一致。
立即学习“go语言免费学习笔记（深入）”；
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 时间戳用 Unix 秒级（
time.Now().Unix()），服务端允许最多 300 秒偏差，超过直接拒绝 - 随机串（nonce）长度建议 16 字节以上，用
crypto/rand.Read生成，防止预测 - body SHA256 必须在原始字节层面计算，不要先 JSON.Unmarshal 再重 Marshal —— 字段顺序、空格、换行都会影响哈希值
- 签名密钥不能硬编码，应从环境变量或 secret manager 加载，且不同服务使用不同密钥
Go 标准库 crypto/hmac 性能够用，别自己实现 Base64 或 Hex 编码
crypto/hmac 在大多数微服务 QPS 下无瓶颈（实测单核 10k+ ops/s），比引入第三方签名库更可控。关键是要用对编码方式：签名结果必须用标准 Base64（不是 URL-safe 变种），否则客户端和服务端解码不一致。
常见坑是客户端用 base64.URLEncoding 编码，服务端用 base64.StdEncoding 解码，导致 illegal base64 data 错误；或者 body 拿到的是 gzip 压缩流，没先解压就哈希，导致签名不匹配。
- 签名计算后用
base64.StdEncoding.EncodeToString输出 - 验证前先用
base64.StdEncoding.DecodeString解码，失败立即返回 401 - 若请求带
Content-Encoding: gzip，中间件需先解压 body（用gzip.NewReader），再计算 SHA256，否则签名无效 - 避免用
fmt.Sprintf拼接签名原文，用bytes.Join或strings.Builder更安全（防注入、控格式）
测试签名验证必须覆盖空 body、JSON 和 form-data 三种典型场景
很多签名逻辑在 JSON API 上跑得通，但遇到 application/x-www-form-urlencoded 或 multipart/form-data 就失败——因为 body 读取方式不同，或自动解析改变了原始字节流。单元测试必须显式构造这三类请求，验证签名生成与验证一致性。
尤其注意：form-data 请求的 boundary 是动态生成的，不能固定写死测试用例；正确做法是用 http.NewRequest 构造，然后用 httptest.NewRecorder 捕获原始 wire bytes 来做签名。
- 空 body 请求：
http.NewRequest("GET", "/api/v1/user", nil)，body 为nil，签名原文中 body hash 用空字符串 - JSON 请求：设置
Content-Type: application/json，body 用bytes.NewReader([]byte{'{', '"id":123', '}’})，避免 json.Marshal 产生空格差异 - Form 请求：用
url.Values{"name": []string{"test"}, "age": []string{"25"}}，调v.Encode()得到原始 form 字节，再设 body - 测试时服务端和客户端用同一套密钥、同一时间戳（固定值），排除时钟漂移干扰
