/admin路由必须用Group()包裹，因为需统一前缀、中间件（如鉴权）和模块隔离；直接r.GET()会导致路径散落、中间件遗漏、维护困难，且无法继承分组级中间件，易引发安全漏洞与执行顺序错误。
为什么/admin路由必须用Group()包裹，不能直接写r.GET("/admin/login")
因为后台管理路由几乎必然需要统一前缀（如/admin）、统一中间件（如鉴权、权限检查）和模块隔离。直接用r.GET()注册会导致路径散落、中间件重复添加、后续维护困难。更关键的是：不走Group()就无法天然继承分组级中间件，比如AuthMiddleware()加在分组上，所有子路由自动受控；而加在单个.GET()里，漏一个就等于开一个后门。
分组中间件顺序错了，登录态校验就可能失效
典型错误是把鉴权中间件放在分组外、日志或恢复中间件放在分组内——Gin 的中间件执行是洋葱模型，外层先执行。如果r.Use(Recovery())在全局，而adminGroup.Use(AuthMiddleware())在分组里，那 panic 发生在 Auth 之前，Recovery()根本捕获不到。正确做法是：
- 全局只放最外层兜底中间件（如
Recovery()、Logger()） - 鉴权类中间件一律放在分组初始化时传入：
admin := r.Group("/admin", AuthMiddleware(), PermissionCheck()) - 避免在分组内混用
.Use()和构造时传参，二者等价但混用易引发顺序误判
抽离admin路由文件时，函数参数类型不能是*gin.Engine
常见翻车点：把func InitAdminRoutes(r *gin.Engine)写进admin/routes.go，然后在main.go里调用InitAdminRoutes(r)。这样所有.GET()都注册到根引擎，/admin前缀彻底丢失，路径变成/login而非/admin/login。
必须改成接收*gin.RouterGroup：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
func InitAdminRoutes(rg *gin.RouterGroup) {
rg.GET("/login", loginHandler)
rg.POST("/doLogin", doLoginHandler)
rg.GET("/dashboard", dashboardHandler)
}
调用侧要先创建分组再传入：admin := r.Group("/admin", AuthMiddleware()); InitAdminRoutes(admin)。
带前缀的嵌套路由容易漏掉花括号{}块
r.Group("/admin").GET("/login", h)看着简洁，实际注册的是/login——Go 编译器忽略Group()返回值，.GET()默认落到*gin.Engine上。必须用{}显式绑定作用域：
admin := r.Group("/admin", AuthMiddleware())
{
admin.GET("/login", loginHandler)
admin.POST("/doLogin", doLoginHandler)
admin.GET("/logout", logoutHandler)
}
这个{}不是风格问题，是 Go 作用域机制决定的：只有在块内，admin变量才有效，所有.GET()才能链式调用到它身上。
真正麻烦的不是写错一行代码，而是错误注册后路径看似能访问、日志也打出来了，但中间件没生效——比如用户未登录却进了/admin/dashboard，这种问题在线上很难复现，排查成本远高于写对第一行Group()。
