Beego中间件中直接读取ctx.Request.Body会失败,因其为单次可读流;需在框架解析前用io.NopCloser+bytes.Buffer缓存并重置Body,且仅对POST/PUT/PATCH等请求操作,避免GET开销与大文件内存风险。

中间件里直接读 ctx.Request.Body 会失败
Beego 的 ctx.Request.Body 是单次可读流,一旦被框架内部(比如 ctx.Input.ParseForm() 或控制器自动解析)提前读取,后续在中间件里再调用 ioutil.ReadAll() 就只能拿到空字节。这不是 bug,是 Go HTTP 标准库的底层限制。
必须在 Body 被消费前“偷看”——也就是把原始 Body 替换成一个可重复读的包装体。常见做法是用 io.TeeReader + bytes.Buffer 缓存副本,但要注意:只对需要解析 body 的请求(如 POST、PUT)做,避免 GET 请求无谓开销。
- 注册中间件时限定路径和方法,例如只拦截
/api/*下的POST请求,减少干扰 - 用
ctx.Ctx.Request.Method快速判断,别用正则或字符串查找 - 缓存 body 前先检查
Content-Length,超大请求(如 >10MB)建议跳过,防止内存暴涨
怎么安全地复制并打印请求 Body
不能直接 body, _ := io.ReadAll(ctx.Request.Body) 后再塞回去——Go 的 http.Request.Body 不支持重置。得用 io.NopCloser 把缓存后的 bytes 重新包成 ReadCloser。
示例代码片段(放在中间件函数开头):
if ctx.Ctx.Request.Method == "POST" || ctx.Ctx.Request.Method == "PUT" || ctx.Ctx.Request.Method == "PATCH" {
body, _ := io.ReadAll(ctx.Ctx.Request.Body)
// 打印原始 body(注意:生产环境慎用,可能含敏感字段)
log.Printf("Request Body: %s", string(body))
// 恢复 body 供后续 controller 使用
ctx.Ctx.Request.Body = io.NopCloser(bytes.NewBuffer(body))
}
- 务必只在明确需要解析 body 的方法中执行,GET/HEAD/OPTIONS 完全跳过
-
io.ReadAll可能 panic(如 body 已关闭),加 defer recover 更稳妥 - 如果 controller 用了
ctx.Input.Bind()或ctx.Input.JSON(),它们内部也会读 body,所以这个复制逻辑必须在所有这些调用之前
响应 Body 怎么捕获不到?因为 Beego 不暴露 ResponseWriter 原始输出流
Beego 的 context.Context 默认不提供可拦截的响应流。你看到的 ctx.ResponseWriter 是个封装体,写入内容直接发给 client,无法 hook。
唯一可行方案是用 beego.BeeApp.Handlers.AddMethodFilter() 注册到 AfterExec 阶段,在 controller 执行完、响应即将写出前,从 ctx.Output.Body 里取内容——但前提是 controller 显式调用了 this.Data["json"] = xxx; this.ServeJSON() 这类方法,否则 ctx.Output.Body 为空。
-
AfterExec阶段能读到ctx.Output.Status和ctx.Output.Body,但仅限于 Beego 自动管理的响应(JSON、XML、模板渲染) - 如果 controller 直接调用
ctx.Ctx.ResponseWriter.Write(),这部分内容完全绕过ctx.Output.Body,无法捕获 - 想 100% 拦截响应,得自己实现
http.ResponseWriter包装器,并替换ctx.Ctx.ResponseWriter,但 Beego 不允许外部替换,风险极高,不推荐
真正实用的日志方案:只记关键字段,放弃完整 Body
线上环境几乎从不打印完整请求/响应 Body。一是性能损耗大,二是审计与合规风险高(token、密码、身份证号等)。更合理的做法是提取结构化字段记录:
- 请求:记录
ctx.Input.URI()、ctx.Input.Query()、ctx.Input.Header("X-Request-ID")、ctx.Ctx.Request.Method - 响应:记录
ctx.Output.Status、ctx.Output.ContentType、耗时(用time.Since()在BeforeExec和AfterExec间计算) - 敏感参数名(如
password、id_card)在日志前主动过滤掉,用strings.ReplaceAll()简单脱敏
Body 级别的调试只保留在本地开发环境,且应通过配置开关控制,上线前默认关闭。Beego 的 logs 模块支持按 level 分离,把 body 日志设为 LevelDebug,生产用 LevelInfo 即可过滤掉。











