必须在中间件中立即读取并重置body:先io.readall(c.request().body)获取原始字节,再用io.nopcloser(bytes.newreader(plain))重新赋值c.request().body,且解密须在bind等操作前完成,注册顺序需早于其他依赖body的中间件。

中间件里怎么拿到原始请求体
默认情况下,echo.Context 的 c.Request().Body 在调用过 c.Bind() 或访问 c.FormValue() 后会被消费掉,后续读取会返回空。解密必须在 body 被解析前完成,否则拿不到密文。
实操建议:
- 在中间件中立即调用
io.ReadAll(c.Request().Body)读取原始字节,保存到局部变量 - 用
io.NopCloser将解密后的明文字节重新包装成io.ReadCloser,再赋给c.Request().Body - 注意:不要直接修改
c.Request()的其他字段(如ContentLength),否则可能触发 echo 内部校验失败
解密逻辑该放在 middleware 还是 handler
必须放在中间件。因为 echo.Context.Bind()、c.JSON() 等方法内部会自动调用 json.Unmarshal() 或 form.Decode(),它们依赖原始 Body 流。如果解密拖到 handler 里,绑定时已经读过一遍空 body,必然报 invalid character '' looking for beginning of value 或类似错误。
典型错误写法:
func handler(c echo.Context) error {
// ❌ 错!此时 Body 已被 echo 内部提前读取(尤其启用了 Recover、Logger 中间件时)
raw, _ := io.ReadAll(c.Request().Body)
plain := decrypt(raw)
// 后续 c.Bind(&v) 仍会失败
}
正确做法:解密中间件注册顺序要 早于 echo.MiddlewareFunc 类型的其他中间件(如 echo.HTTPErrorHandler 不影响,但 echo.Logger() 默认不读 body,可后置)。
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
如何兼容 JSON 和 form-data 两种密文格式
不能一概而用 application/json 解析:表单提交时 Content-Type 是 multipart/form-data 或 application/x-www-form-urlencoded,直接按 JSON 解密会丢 key-value 结构。
实操建议:
- 先检查
c.Request().Header.Get("Content-Type"),区分处理路径 - 对
application/json:读完整 body,解密为[]byte,再塞回Body - 对
application/x-www-form-urlencoded:用c.Request().ParseForm()后,遍历c.Request().PostForm,对每个 value 单独解密(注意 URL 编码需先url.QueryUnescape) - 对
multipart/form-data:必须用c.Request().MultipartReader()手动解析,对每个part的内容流解密(不能整体读 body,否则破坏 boundary)
密钥和算法参数从哪来、怎么传
硬编码密钥或写死 IV 是高危操作。实际项目中,密钥通常来自请求头(如 X-Enc-Key-ID)、URL 参数(仅限调试)、或服务端配置(如 Vault)。IV 必须随密文一起传输,常见做法是密文前 16 字节放 IV(AES-CBC)或附加在密文末尾(AES-GCM)。
容易踩的坑:
-
X-Enc-Key-ID头没做白名单校验,导致任意 key ID 都可被尝试 → 引发密钥爆破 - 解密失败时直接返回 500,暴露了加解密流程细节 → 改成统一返回
400 Bad Request并抹去错误信息 - 没校验密文长度(如 AES-CBC 要求是块大小整数倍),导致 panic → 先
len(data) % 16 == 0判断再解密 - 使用
crypto/aes时忘记显式指定模式(cipher.NewCBCDecrypter)和填充方式(PKCS7)
复杂点在于:不同客户端可能用不同语言加密(如 Java 的 Cipher.getInstance("AES/CBC/PKCS5Padding") 实际等价于 PKCS7),得对齐填充逻辑;GCM 模式还要校验 tag,失败时不能只返回错误,得确保整个请求生命周期内不泄露中间状态。










