中间件中无法篡改原始request,应通过ctx.Values().Set()存清洗后参数,控制器优先读ctx.Values()而非ctx.PostValue();JSON请求需在控制器层解析,敏感词过滤须启动时加载内存并重校验长度。

中间件里怎么拿到原始请求参数
在 Iris 中,iris.Context 不会自动解析表单或 JSON 请求体里的字段到 ctx.FormValue() 或 ctx.PostValue() 之外的结构中。如果你用的是 JSON 提交(比如前端发 Content-Type: application/json),ctx.PostValue() 是拿不到的——必须先调用 ctx.ReadJSON() 或 ctx.ReadForm() 才能读取内容,但这时数据已经“过一遍”了,中间件再改就晚了。
所以敏感词过滤中间件必须在「解析前」介入,核心是:只处理 ctx.Request().Method == "POST" 或 "PUT",且 Content-Type 包含 application/x-www-form-urlencoded 或 multipart/form-data 的请求;对 JSON 请求,要么强制前端转成表单格式,要么把过滤逻辑下沉到控制器层(不推荐)。
- 不要依赖
ctx.FormValues()—— 它内部会触发一次解析,可能破坏后续业务逻辑 - 要用
ctx.Request().Body原始字节流 +io.MultiReader复用,否则 body 会被读空 - 对
multipart/form-data,需用ctx.Request().ParseMultipartForm()后从ctx.Request().MultipartForm.Value取值,不能直接读 body
怎么安全地替换参数值而不影响路由和绑定
Iris 的 ctx.PostValue() 和 ctx.FormValue() 是只读封装,你不能直接修改底层 http.Request 的 PostForm 或 MultipartForm 字段——改了也没用,因为 Iris 在调用控制器前已缓存过这些值。真正有效的做法是:在中间件里预处理并覆盖 ctx.Values().Set() 存一份清洗后的键值对,然后让控制器优先读 ctx.Values().GetString() 而不是 ctx.PostValue()。
- 例如:中间件中做
ctx.Values().Set("title", filter.Replace(ctx.PostValue("title"))) - 控制器里统一用
ctx.Values().GetString("title"),而不是ctx.PostValue("title") - 避免覆盖原生 key(如
"username"),建议加前缀如"filtered_username"防冲突
敏感词替换逻辑放哪最合适
别把 PropertiesUtil.readProperties() 这类 IO 操作写在中间件函数体内——每次请求都去读磁盘,性能崩得比数据库还快。应该在应用启动时(app.Run() 前)一次性加载进内存 Map,并用 sync.RWMutex 包裹读写,或者直接用 map[string]string + atomic.Value 实现无锁读。
- 加载后存在全局变量或注入到
app.Visitor()里,中间件通过ctx.Application()获取 - 替换时注意正则边界:用
\b匹配单词边界,否则"政府"会误杀"人民政府"里的“政府” - 大小写敏感要明确:中文一般不用管,但英文词如
"fuck"建议用strings.ReplaceAll(strings.ToLower(s), "fuck", "**")配合 flag
为什么不能用 HttpServletRequestWrapper 那套包装思路
那是 Java Servlet 的惯用法,Iris 是 Go 写的,没有 HttpServletRequestWrapper 这种抽象层。Go 的 http.Request 是不可变结构体,所有“包装 request”的尝试(比如用自定义 struct 嵌入 *http.Request)都会导致 ctx.Request() 返回的指针失效,Iris 内部很多逻辑(如文件上传、MIME 解析)依赖原始指针地址,一换就 panic。
真正的 Go 式解法是:接受「中间件无法真正篡改原始 request 对象」这个事实,转而用 ctx.Values() 做语义层覆盖 + 控制器配合读取。这是 Iris 的设计哲学决定的,硬套 Java 思维只会踩坑。
最易被忽略的一点:过滤后的字符串长度变化可能影响后续校验(比如用户名长度限制为 20 字符,过滤后变成 "**" 就只剩 2 字符),这类业务约束必须在过滤后重新校验,不能假设“前端传多少,后端就收多少”。


















