签名验证必须在Echo中间件中统一处理，且需在c.Bind()前读取并重置原始body；签名字段从header提取，时间戳偏差≤300秒，待签字符串按字母序拼接固定字段，密钥从环境变量加载，multipart等场景跳过body签名，验签失败返回401/403且不泄露敏感信息。
签名验证逻辑必须放在中间件里统一处理
所有 API 接口的签名校验不能散落在各个 handler 中，否则容易漏掉、重复或参数解析顺序不一致。Echo 的 echo.MiddlewareFunc 是唯一合理位置，且需在绑定（c.Bind()）之前执行——因为签名依赖原始请求体，而 c.Bind() 会消费 body 流，后续再读就为空。
- 用
c.Request().Body读取一次原始 body，存入 context 或临时变量，再用io.NopCloser重置回 request body，确保后续 Bind 正常 - 签名字段（如
sign、timestamp、nonce）应从 query 或 header 提取，避免和 JSON body 混淆；推荐 header（X-Sign、X-Timestamp）更干净 - 时间戳偏差必须校验，例如允许 ≤ 300 秒，防止重放攻击：
if now.Unix()-ts > 300 || ts-now.Unix() > 300
签名生成要用确定性排序 + 预定义密钥 + HMAC-SHA256
客户端和服务端必须用完全一致的方式拼接待签名字符串，任意字段顺序、空格、编码差异都会导致验签失败。不要用 map 遍历拼接（无序），也不要直接序列化整个 struct（字段可能被忽略或加 tag）。
- 待签名参数只取显式声明的字段：比如固定取
method、path、timestamp、nonce、body_md5（非原始 body） - 按字母升序拼接键值对：
fmt.Sprintf("method=%s&nonce=%s&path=%s×tamp=%d", method, nonce, path, ts) - 密钥绝不硬编码，从环境变量或配置中心加载，例如
os.Getenv("API_SECRET_KEY")；签名算法必须用hmac.New(sha256.New, key)，不用 md5 或 sha1
body MD5 计算必须避开 multipart 和 streaming 场景
如果接口支持文件上传（multipart/form-data）或大体积流式 body，直接算 MD5 会吃光内存或阻塞请求。此时应跳过 body 参与签名，改用其他稳定标识，比如只签 query + header + path。
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 判断 Content-Type：
strings.HasPrefix(c.Request().Header.Get("Content-Type"), "multipart/")，是则忽略 body - 对普通 JSON 请求，用
io.Copy(ioutil.Discard, c.Request().Body)前先读一遍并计算 MD5，但注意 body 已被消耗，需用bytes.NewReader重置 - 更稳妥的做法是要求客户端把 body 的 hex-MD5 放在 header（如
X-Body-MD5），服务端只校验该值是否匹配，不自己算
验签失败必须返回标准错误且不泄露细节
HTTP 状态码用 401 Unauthorized（签名无效）或 403 Forbidden（时间戳超时/重复 nonce），绝不能返回 500 或带堆栈的响应。错误信息里禁止出现密钥、算法名、原始待签字符串等敏感内容。
立即学习“go语言免费学习笔记（深入）”；
- 日志中可记录 trace_id + 错误类型（如
"sign_mismatch"、"timestamp_expired"），但不打明文签名或参数 - 为防暴力试探，对连续失败的 IP 可加简单限流（如 5 次/分钟），但别用复杂中间件增加延迟
- 测试时最容易踩的坑：本地开发用 HTTP，但客户端签名按 HTTPS 拼接
path或host；务必确认协议、host、path 的实际值和签名时完全一致
