敏感路由参数须在中间件中统一解密并存入上下文,不可裸露传输或在handler中重复解密;解密中间件应注册于API分组而非全局,失败时立即返回400且不打debug日志。

敏感路由参数(如 :id、:token)不能裸露传输,直接解密必须在进入业务逻辑前完成,否则 handler 里拿到的就是密文,后续所有校验、查询、日志都会出错。最稳妥的做法是用中间件统一解密,并把明文写回 c.Param() 可访问的位置。
解密中间件必须放在路由匹配之后、handler 执行之前
Echo 的中间件执行顺序是「洋葱模型」,但路由匹配(即 c.Param("id") 的值来源)发生在所有中间件之前。也就是说,c.Param("id") 拿到的是原始 URL 中的密文字符串,你无法靠 e.Use() 在它之前改写参数值。
正确时机是:路由已匹配 → 参数已提取 → 中间件开始执行 → 此时你可以读取 c.Param("id"),解密,再用 c.Set("decrypted_id", plain) 存入上下文;后续 handler 从 c.Get("decrypted_id") 读,而不是直接用 c.Param("id")。
- 不要尝试修改
c.(*echo.context).pvalues等内部字段——这是未导出字段,版本升级可能崩 - 避免在 handler 里重复解密:每个敏感参数只解一次,放中间件里做
- 如果多个参数都要解(如
:user_id和:order_id),建议统一命名规则,比如都存为c.Set("decrypted_"+key, value)
解密失败要立即中断,不能传给下游 handler
解密失败通常意味着参数被篡改或过期,此时返回 400 或 404 更合理,而不是让 handler 去查一个不存在的 ID 导致 500 或泄露信息。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 解密函数返回
(string, error),中间件里检查 error 不为 nil 就直接return c.NoContent(http.StatusBadRequest) - 不要用
panic或log.Fatal,那会杀掉整个 goroutine - 对无效密文不打 debug 日志,防止攻击者通过响应时间或日志内容反推加密方式
路由参数解密和查询参数解密不能混用同一套逻辑
c.Param("id") 来自路径,c.QueryParam("sign") 来自 query string,它们的编码方式、有效期、签名策略往往不同。强行复用一套解密函数容易漏掉关键校验点。
- 路径参数通常要求强一致性(如用户 ID 必须存在且未过期),适合带 HMAC 验证的 AEAD 加密(如
aes-gcm) - 查询参数更常用于临时令牌(如分享链接中的
?t=enc_...),可接受短时效+简单 base64+AES-CBC,但必须校验 timestamp 字段 - 绝不把
Authorization头里的 token 解密逻辑塞进路由参数中间件里——那是鉴权层的事,职责分离
真正容易被忽略的点是:解密中间件注册位置。它必须放在 e.Group("/api").Use(decryptMiddleware) 这类组中间件中,而不是全局 e.Use();否则像 /health 或静态资源路由也会被强制解密,导致 400 泛滥。路由分组不是装饰,是语义隔离的实际需要。










