Echo 没有内置 route:list 命令,需手动遍历 e.Router().routes 和 e.Router().tree(DFS)才能获取全部路由,注意 node.kind 区分 static/param/any,并确保在启动后执行。

Echo 没有内置 route:list 命令
和 Laravel 不同,Echo 框架本身不提供类似 php artisan route:list 的 CLI 命令来打印路由列表。它没有运行时路由检查工具,也没有默认暴露的调试端点。所有路由信息只存在于内存中,且仅在启动时构建完成,之后无法通过命令行直接查看。
手动遍历 Router 结构体获取路由信息
Echo 的路由树由 Router 类型管理,内部用 *node 构建 radix tree,并维护一个 map[string]*Route(按 method+path 做键)。要列出所有注册路由,需在应用启动后、服务监听前,主动访问 e.Router().routes 并递归遍历树节点。
常见错误现象:直接读 e.Router().routes 只拿到部分路由(比如只有静态路径),漏掉带参数(/users/:id)或通配(/files/*)的条目——因为这些是存在 tree 里,不是 flat map。
- 必须同时遍历
e.Router().tree(递归 DFS)和e.Router().routes(查 method+path 映射)才能覆盖全部类型 - 注意
node.kind字段区分:0=static,1=param(:id),2=any(*),不同 kind 的子节点提取逻辑不同 - 示例片段(仅示意结构,不可直接运行):
func dumpRoutes(e *echo.Echo) { router := e.Router() // 先 dump routes map for k, r := range router.Routes() { fmt.Printf("MAP: %s %s → %s\n", r.Method, r.Path, k) } // 再递归遍历 tree walkNode(router.tree, "", func(path string, method string, handler echo.HandlerFunc) { fmt.Printf("TREE: %s %s → %p\n", method, path, handler) }) }
用调试中间件临时注入路由快照
如果不想改启动逻辑,可在开发环境加一个临时中间件,在首次请求时把当前路由状态 dump 到日志或响应中。但要注意:e.Router() 在服务启动后才完整就绪,中间件里调用是安全的;而若在 e.Use() 之前注册该中间件,可能看到空结果。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 只应在
APP_ENV=local或调试开关开启时启用,生产环境禁用 - 避免在中间件里做深度遍历并返回 HTML —— 容易阻塞主线程、拖慢首请求
- 更轻量的做法:把路由摘要写入
debug/routes.json文件,用curl http://localhost:8080/debug/routes触发生成,再用cat debug/routes.json查看
第三方工具或自行封装 CLI 命令
社区无主流路由查看工具,但你可以基于 github.com/urfave/cli 或 spf13/cobra 封装一个 go run cmd/routes.go 脚本,复用上面的遍历逻辑。关键点是:脚本必须能加载你的 Echo 初始化代码(包括所有 e.GET() 等调用),否则拿到的是空路由树。
容易被忽略的地方:Echo 的路由注册是**惰性执行**的——只有当 e.Start() 或 e.StartServer() 被调用时,才会真正构建完整路由树。所以任何离线分析脚本,都得模拟启动流程(哪怕不监听端口),否则 e.Router().tree 是 nil。










