如何为Chi框架的子路由正确应用中间件？

核心原因与修复方案 #

1. 调整中间件挂载顺序（最常见问题） #

Chi路由组的中间件是按配置顺序绑定到后续路由的，如果先注册路由再添加中间件，已注册的路由不会关联新中间件，导致中间件完全不生效。

错误写法：

r := chi.NewRouter()
fooGroup := r.Group("/foo-group")
// 错误：先注册路由，后加中间件，中间件无法绑定到该路由
fooGroup.Post("/sub-route", createResourceHandler)
fooGroup.Use(middleware.AllowContentType("application/json"))

正确写法：

r := chi.NewRouter()
fooGroup := r.Group("/foo-group")
// 正确：先添加中间件，再注册路由，中间件会作用于组内所有后续路由
fooGroup.Use(middleware.AllowContentType("application/json"))
fooGroup.Post("/sub-route", createResourceHandler)

2. 验证请求与路由的匹配性 #

• 确保测试用例的请求方法（如POST）和路由注册的方法完全一致，比如路由用Post就别用Get发起测试；
• 确认请求路径和注册的/foo-group/sub-route完全匹配，避免拼写错误或路径层级问题。

3. 规范测试请求的Content-Type头 #

测试时要明确设置非JSON类型的Content-Type，比如text/plain，不要完全省略该头（部分场景下中间件会允许无Content-Type的请求）。

示例测试用例：

func TestSubRouteContentTypeValidation(t *testing.T) {
	r := chi.NewRouter()
	fooGroup := r.Group("/foo-group")
	fooGroup.Use(middleware.AllowContentType("application/json"))
	fooGroup.Post("/sub-route", func(w http.ResponseWriter, r *http.Request) {
		w.WriteHeader(http.StatusCreated)
	})

	// 构造非JSON请求
	req := httptest.NewRequest(http.MethodPost, "/foo-group/sub-route", strings.NewReader("invalid content"))
	req.Header.Set("Content-Type", "text/plain")
	w := httptest.NewRecorder()

	r.ServeHTTP(w, req)

	if w.Code != http.StatusUnsupportedMediaType {
		t.Errorf("期望状态码415，实际得到%d", w.Code)
	}
}

4. 确认中间件包的正确性 #

确保使用的是Chi官方中间件包：github.com/go-chi/chi/v5/middleware，避免误用自定义的同名中间件导致逻辑不符。

关键原理 #

Chi路由组的Use方法只会为调用该方法之后注册的路由绑定中间件，先注册路由再添加中间件的操作，不会回溯修改已存在的路由配置，这是导致中间件不生效的核心逻辑原因。

内容的提问来源于stack exchange，提问作者baitendbidz