必须用 e.Group() 统一管理后台路由，因其能自动继承前缀、集中注册中间件、支持嵌套分组，避免路径不一致、权限重复挂载及批量改前缀脆弱等问题。
直接用 e.Group() + 中间件 + 路由前缀就能干净地统一管理后台路由，不需要额外框架或插件。
为什么必须用 e.Group() 而不是手写一堆 e.GET("/admin/xxx")
硬编码路径前缀（比如反复写 /admin/users、/admin/logs）会导致三类问题：路径不一致（漏写斜杠、大小写混用）、权限中间件重复注册、升级时批量改前缀极其脆弱。而 e.Group("/admin") 把前缀、中间件、子路由全部收束在一个作用域内，后续增删模块只改组内代码，不影响其他路由。
-
e.Group()返回的是新路由实例，所有子路由自动继承前缀，GET("/users")实际注册为/admin/users - 中间件只注册一次（如鉴权、日志），对组内所有路由生效，不会漏挂也不会重复挂
- 支持嵌套分组：
userGroup := adminGroup.Group("/users")→/admin/users/list、/admin/users/detail/:id
e.Group() 配合后台典型中间件的写法
后台路由几乎必然需要登录态校验、菜单权限检查、操作日志记录。这些不该散落在每个 handler 里，而应作为组级中间件集中控制：
- 登录中间件：检查
c.Get("user_id")是否存在，不存在则重定向到/login或返回 401 - 菜单权限中间件：从 DB 或缓存查当前用户能访问的菜单码（如
sys:user:list），匹配当前请求路径对应的权限标识 - 操作日志中间件：在 handler 执行后记录方法、路径、耗时、是否成功，但注意过滤敏感参数（如密码字段）
示例注册方式：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
admin := e.Group("/admin")
admin.Use(authMiddleware, menuPermMiddleware, opLogMiddleware)
admin.GET("/dashboard", dashboardHandler)
admin.GET("/users", listUsersHandler)
admin.POST("/users", createUserHandler)
静态资源和 API 路由要分开处理
后台通常包含两部分：前端 HTML/JS/CSS（如 Layui 页面）和后端 JSON API。别把它们混在同一个组里——静态资源走文件服务，API 走 JSON 处理，职责清晰且便于加不同中间件：
- 静态资源建议用
e.Static()单独挂载：e.Static("/static", "./web/static")，路径不经过任何中间件（或只过压缩中间件） - API 路由必须走
admin.Group("/api")，并启用 CORS、JSON body 解析、参数验证等中间件 - 避免把
/admin/login.html和/admin/api/login放同一组——前者是页面渲染，后者是接口调用，错误处理、响应格式、鉴权粒度都不同
路由参数和通配符容易踩的坑
后台菜单常有动态 ID（如 /admin/users/123/edit）或可选查询（如 /admin/logs?page=1&size=20），但 e.Group() 本身不处理参数匹配逻辑，全靠子路由定义：
-
admin.GET("/users/:id", userDetailHandler)—— 正确，:id会被c.Param("id")拿到 -
admin.GET("/logs", listLogsHandler)—— 查询参数自动可用，用c.QueryParam("page")取，不用写进路径 - 别写
admin.GET("/users/*", ...)，这是反向代理用的通配符，Echo 的路径参数不认*，会报错或匹配失败 - 如果真需要模糊匹配（如
/admin/anything/else/...），用admin.Any("/*", fallbackHandler)，但仅限兜底，别当主路由用
真正麻烦的是嵌套路由中路径参数名冲突（比如 /admin/posts/:id/comments/:id），这时必须改名：/admin/posts/:postID/comments/:commentID，否则 c.Param("id") 只取到最后一个。
