Beego 用 Filter 替代中间件,敏感词过滤须置于 BeforeRouter 阶段以获取原始请求体、查询参数、Header 和 URL 路径参数;Controller 内过滤因请求体已被解析或清空而失效。

Beego 框架本身不提供“中间件”概念(如 Gin 或 Echo 那样的 Use 链式中间件),它的等效机制是 Filter —— 一种基于请求生命周期的钩子函数,注册在 beego.InsertFilter 中。敏感词过滤必须放在 BeforeRouter 阶段,否则无法拦截未匹配路由的请求体;若放错阶段,ctx.Input.RequestBody 可能为空或已被解析,导致过滤失效。
为什么不能用 Controller 方法内过滤?
Controller 方法执行时,请求体往往已解析为 ctx.Input.RequestBody 或自动绑定到结构体,但:
- 若请求是 application/json,Beego 默认已调用 json.Unmarshal,原始字节流不可再读;
- 若是 application/x-www-form-urlencoded 或 multipart/form-data,ctx.Input.RequestBody 在首次调用 GetString/GetStrings 后会被清空;
- 敏感词需扫描原始输入(含 URL 查询参数、Header、Body),必须在路由分发前统一处理。
如何注册 BeforeRouter Filter 进行全量扫描?
在 main.go 的 init() 或 main() 函数中注册,使用 beego.InsertFilter 并指定 beego.BEFORE_ROUTER 阶段:
beego.InsertFilter("/*", beego.BEFORE_ROUTER, func(ctx *context.Context) {
// 1. 获取原始请求体(仅对 POST/PUT/PATCH 且非 form-data 有效)
if ctx.Input.Method == "POST" || ctx.Input.Method == "PUT" || ctx.Input.Method == "PATCH" {
body := ctx.Input.RequestBody
if len(body) > 0 && !strings.Contains(ctx.Input.Header("Content-Type"), "multipart/form-data") {
if hasSensitiveWord(string(body)) {
ctx.Abort(400, "contains forbidden words")
return
}
}
}
// 2. 扫描查询参数
for _, v := range ctx.Input.Query() {
if hasSensitiveWord(v) {
ctx.Abort(400, "query contains forbidden words")
return
}
}
// 3. 扫描 Header(如 User-Agent、Referer 等可配置字段)
if hasSensitiveWord(ctx.Input.Header("User-Agent")) {
ctx.Abort(400, "UA contains forbidden words")
return
}
})
注意:ctx.Input.RequestBody 在 BEFORE_ROUTER 阶段是可读的,但 Beego 不会自动重置它;后续 Controller 中仍可正常使用 GetString 等方法 —— 因为 Beego 内部做了缓冲处理。
敏感词匹配性能与误判怎么平衡?
简单 strings.Contains 易误杀(如“苹果”命中“苹果手机”也命中“苹果汁”),但正则或 AC 自动机引入额外依赖和初始化开销。生产建议:
- 使用预编译的 *regexp.Regexp 匹配带边界词(如 \b(傻逼|垃圾)\b),避免跨词匹配;
- 将敏感词列表加载进内存 map,先做哈希快速筛查,再对命中项走正则精筛;
- 对 Body 做 UTF-8 安全截断(防止超长文本阻塞),例如只检查前 1MB;
- 避免在 Filter 中做 I/O(如每次查数据库),词库应初始化时加载并热更新(通过信号或定时 reload)。
最容易被忽略的一点:Beego 的 ctx.Input.Params(URL 路径参数)默认不进入 Query(),需单独遍历 ctx.Input.Params 切片进行扫描 —— 否则 /api/user/傻逼 这类路径会绕过过滤。


















