模块化路由配置的核心是避免维护困难、中间件漏挂和前缀不一致，需用函数接收*gin.RouterGroup参数，在main.go中创建分组后传入各模块，路径前缀自动继承，中间件显式挂载，禁用嵌套Group以防路径断裂和中间件失效。
模块化路由配置不是为了“看起来整洁”，而是避免 r.GET 和 r.POST 散落在 main.go 里导致维护困难、中间件漏挂、版本前缀不一致——直接后果是上线后 404、405、鉴权失效。
怎么把路由拆到独立文件里而不丢失中间件和前缀
核心是让每个模块只管自己的逻辑，不碰全局引擎实例。用函数接收 *gin.RouterGroup 参数，内部注册子路由并挂载中间件：
- 定义模块初始化函数，例如
userRouter.Setup(router *gin.RouterGroup)，参数类型必须是*gin.RouterGroup，不是*gin.Engine - 在
main.go中先创建分组（如v1 := r.Group("/api/v1")），再传给各模块：userRouter.Setup(v1)、orderRouter.Setup(v1) - 模块内不能再调用
r.GET，只能用传入的router.GET；中间件也必须在分组上挂载，例如v1.Use(authMiddleware)，不能写在模块函数内部 - 路径前缀由分组自动继承，模块里写
router.GET("/users", handler)，实际注册的是/api/v1/users
为什么 r.Group("/v1").Group("/admin") 容易出错
嵌套 Group() 看似自然，但会拼出双斜杠或路径断裂，比如 r.Group("/v1").Group("/admin") 生成的完整路径是 /v1/admin/xxx，而 r.Group("/v1/admin") 才是预期形式。更隐蔽的问题是中间件作用域错乱：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 外层
Group挂的中间件不会自动透传给内层Group实例，必须显式重复调用.Use() - 如果某模块误用
r.Group("")或r.Group("/")，会导致路径计算异常，calculateAbsolutePath内部可能返回空字符串或重复根路径 - 调试时打印
r.Routes()会看到大量重复或错位的路由条目，尤其在热重载或测试多版本共存时
c.Param("id") 返回空字符串却不报错，怎么安全取值
路径参数缺失时 c.Param("id") 不 panic，也不返回 error，只返回空字符串 —— 这是 Gin 的设计选择，但业务代码必须自己兜底：
- 不要直接对
c.Param("id")做strconv.Atoi，先判断len(c.Param("id")) == 0 - 若该参数为必填项，应统一返回
c.AbortWithStatusJSON(400, gin.H{"error": "id is required"}) - 多个参数如
/user/:uid/post/:pid，必须分别校验c.Param("uid")和c.Param("pid")，不能假设其中一个存在另一个就一定存在 - 别用
c.DefaultQuery("id", "0")替代c.Param("id")，query 参数和 path 参数语义不同，混用会破坏 REST 约定且影响缓存
关闭重定向后，为什么还遇到 301 跳转
即使设置了 r.RedirectTrailingSlash = false 和 r.RedirectFixedPath = false，某些情况仍会跳转：
- 前端发请求时带了尾斜杠（如
/user/123/），而路由注册的是/user/:id（无尾斜杠），httprouter 底层仍可能触发RedirectTrailingSlash，需确认是否在gin.New()后立即设置，而不是gin.Default()后 - 反向代理（如 Nginx）可能主动添加或移除斜杠，Gin 层面已无法干预，需在代理配置中统一处理
- 浏览器地址栏手动输入带斜杠的 URL，会触发客户端缓存重定向，和 Gin 无关，需清缓存或换浏览器验证
真正的模块化不是靠文件拆分，而是让每个路由组的生命周期、中间件依赖、错误处理边界都清晰可辨；最容易被忽略的是路径参数校验和重定向关闭时机——它们不出现在文档首页，却在联调阶段高频引发问题。
