http.ServeMux不支持路由组，因其仅做纯前缀匹配、无嵌套结构、不保存路径层级关系，也无法挂载中间件；需手写RouterGroup结构体，通过prefix拼接、中间件链式包装及path.Join安全处理实现类似gin.Group()的语义。
为什么直接用 http.ServeMux 做不了路由组
因为 http.servemux 是纯前缀匹配、无嵌套结构的简单分发器，它不保存路径层级关系，也不支持中间件挂载点。你注册 /api/v1/users 和 /api/v1/posts 时，无法自动共享 /api/v1/ 这一层的公共前缀处理逻辑（比如统一鉴权、cors、日志），更没法把中间件和子路由一起“打包”复用。
所以得自己维护一个树状或前缀索引结构，并在匹配时做路径裁剪 + 上下文传递。
用 net/http 手写路由组的核心三步
不需要第三方库，靠 http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 组合就能实现干净的路由组语义：
- 定义一个
RouterGroup结构体，持有prefix string、https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705s []func(http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705（中间件）、以及指向父http.ServeMux或上层RouterGroup的引用 - 提供
Group(prefix string)方法返回新子组，新组的prefix是父组 prefix + 当前 prefix（如g.Group("/users")在/api下生成/api/users） - 所有
GET/POST方法内部不做直接注册，而是调用addRoute(method, fullPath, h)，其中fullPath = g.prefix + path，再 wrap 中间件链后注册到底层http.ServeMux
关键点：中间件必须是 func(http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 类型，这样能用 next := mw(next) 链式包裹，且最终注册的是包装后的 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705，不是原始 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705。
gin.Group() 风格 API 的实际约束
Go 标准库没有反射路由参数解析（如 :id），所以「路由组」本身不解决路径参数提取——那是路由匹配器的事。如果你用 gorilla/mux 或 chi，它们的 Group 只是语法糖，底层仍依赖各自路由树；而手写时若想支持 /users/:id，就得自己实现路径 segment 分割 + 占位符识别，或者直接集成 httprouter 这类带参数提取的匹配器。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
常见坑：
- 中间件顺序错乱：注册时从左到右 wrap，但执行时是倒序（最外层中间件最先执行），调试时容易误判日志顺序
- 路径拼接漏掉
/：比如父组prefix="/api"，子组Group("v1")拼成/apiv1，必须显式处理边界斜杠 - 子组注册后无法独立启动：所有 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 最终都得挂到同一个
http.ServeMux实例上，不能每个组持有一个 mux
一个最小可运行的组注册示例
type RouterGroup struct {
prefix string
mux *http.ServeMux
middlewares []func(http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705
}
<p>func (g <em>RouterGroup) Group(prefix string) </em>RouterGroup {
full := path.Join(g.prefix, prefix)
return &RouterGroup{prefix: full, mux: g.mux, middlewares: g.middlewares}
}</p><p>func (g *RouterGroup) GET(path string, h http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705Func) {
fullPath := path.Join(g.prefix, path)
wrapped := g.wrap(h)
g.mux.HandleFunc(fullPath, wrapped.ServeHTTP)
}</p><p>func (g *RouterGroup) wrap(h http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705Func) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 {
https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 := http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705Func(h)
for i := len(g.middlewares) - 1; i >= 0; i-- {
https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 = g.middlewares<a href="https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705">i</a>
}
return https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705
}</p><p>// 使用：
mux := http.NewServeMux()
api := &RouterGroup{prefix: "/api", mux: mux}
v1 := api.Group("/v1")
v1.GET("/users", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("users"))
})
http.ListenAndServe(":8080", mux)
注意 path.Join 会自动处理多余斜杠，比字符串拼接更安全；中间件遍历倒序是为了让第一个注册的中间件成为最外层 wrapper。
真正难的不是写出来，而是当你要加请求体校验、JWT 解析、panic 恢复这些中间件时，怎么保证它们对子组路径裁剪后依然能正确读取原始 URL 和 body——这些细节不显眼，但一出问题就很难定位。
