签名校验必须在 iris.Context 的路由中间件(iris.Handler)层拦截,使用 app.UseGlobal 或 Party().Use 注册,于 ctx.Next() 前完成校验并调用 ctx.Stop(),确保前置安全控制。

签名校验该用 iris.Context 的哪一层拦截?
必须在路由中间件(iris.Handler)里做,不能放在控制器里。因为签名验证是前置安全检查,控制器只负责业务逻辑。如果等请求进到 handler 再校验,攻击者已触发日志、DB 查询或外部调用,防御就晚了。
常见错误是把签名逻辑写在 controller 方法里,导致部分接口漏校验、复用困难、无法统一返回 401/403。Iris 的 UseGlobal 或 Use 是正确位置。
- 全局校验:用
app.UseGlobal(signMiddleware),适合所有 API 接口 - 分组校验:用
api := app.Party("/api"); api.Use(signMiddleware),避免影响静态资源或登录接口 - 务必在
ctx.Next()前完成校验并调用ctx.Stop(),否则会继续执行后续 handler
signMiddleware 怎么提取和解析签名参数?
Iris 默认不自动解析 query + form + JSON 混合参数,而签名往往分布在 URL query(如 sign=xxx×tamp=171...&nonce=abc)和 body(JSON)中。必须手动合并原始参数再排序拼接,否则校验必失败。
关键点:不能直接用 ctx.FormValue 或 ctx.URLParam 单独取,要统一归一化。推荐做法是先读原始 body(仅一次),再解析为 map,最后合并 URL 参数。
- 用
ctx.Request().Body读一次 body,存入ctx.Values().Set("raw_body", b)供后续使用 - 调用
ctx.PostValue("sign")和ctx.URLParam("sign")都可能为空,应优先从统一 map 中取sign、timestamp、nonce - 时间戳校验必须做:拒绝
abs(now - timestamp) > 300(5 分钟)的请求,防止重放 - nonce 要存入 Redis 并设 TTL(略大于时间窗口),发现重复即拒收
签名算法选 HMAC-SHA256 还是 MD5?密钥怎么管?
别用 MD5,它不抗碰撞且无密钥,纯属自欺欺人。必须用带密钥的 HMAC-SHA256,密钥绝不能硬编码在代码里。
Iris 本身不提供密钥管理,得靠外部注入。启动时从环境变量或配置文件加载,通过 app.Run(..., iris.WithConfiguration(iris.Configuration{...})) 传入,再在 middleware 里用 app.GetContextPool().BaseContext().Config().GetString("sign_key") 获取(更推荐用依赖注入容器如 dig 或直接传闭包)。
- 签名原文 = 按字段名 ASCII 升序拼接的
key1=value1&key2=value2&...&keyN=valueN(不含sign字段) - 注意空值处理:空字符串参与拼接,
null或缺失字段直接跳过 - JSON body 要用标准序列化(无空格、键名排序),建议用
jsoniter.ConfigCompatibleWithStandardLibrary.Marshal替代原生json.Marshal - Redis 存 nonce 时 key 建议为
sign:nonce:{client_id}:{nonce},避免不同客户端冲突
如何调试签名失败却没报错的“静默丢弃”问题?
最常踩的坑是 middleware 里 panic 未被捕获,或 ctx.Stop() 后仍输出了默认响应体,导致前端看到 200 空响应,误以为成功。必须显式写状态码和错误消息。
调试阶段建议加日志开关:只在 dev 环境打印原始参数、拼接串、计算出的 sign 和请求 sign 的比对结果。生产环境关闭,但保留结构化错误日志(含 traceID)。
- 用
ctx.StatusCode(iris.StatusUnauthorized)+ctx.JSON(map[string]string{"code": "401", "msg": "invalid sign"})显式响应 - 避免在 middleware 里调用
ctx.WriteString或ctx.JSON后忘记ctx.Stop(),否则会 panic:「cannot write header after body」 - 前端发请求时若用
fetch且未设credentials: 'include',可能导致 Cookie 携带异常,间接影响 client_id 提取——这不属于签名逻辑,但会连带导致校验失败
真正难的是参数归一化细节:大小写、URL decode、空格处理、嵌套 JSON 的扁平化方式。这些不写测试用例覆盖,上线后跨语言客户端(比如 Java 或 Python SDK)极易对不上。


















