Echo框架无route:list命令,需通过e.Routes()手动遍历获取已注册路由列表,返回包含Method、Path、Name的切片,不包含中间件或动态生成路由信息。

echo 没有 route:list 命令,别白跑 Artisan
Go 里没有 Laravel 那套 php artisan route:list,echo 本身不提供命令行导出路由列表的功能。你执行 go run main.go 后直接启动服务,框架不会自动生成或暴露路由清单 —— 它压根没这个设计目标。所有路由注册逻辑都在代码里,查路由 = 看代码 + 补充调试手段。
手动遍历 Router.routes 是最直接的办法
echo 的 Router 结构体内部维护了一个 map[string]*Route 字段(注意不是树形遍历节点),只要拿到 *echo.Echo 实例,就能访问它:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
// 在 main() 或调试入口处加
e := echo.New()
// ... 注册一堆路由 e.GET(...) e.POST(...) ...
// 手动打印全部已注册路由
for _, r := range e.Routes() {
fmt.Printf("METHOD: %s | PATH: %s | NAME: %s\n", r.Method, r.Path, r.Name)
}
-
e.Routes()返回的是[]*echo.Route切片,每个Route包含Method、Path、Name字段,不含中间件信息或分组前缀 - 该方法只反映调用时已注册的路由,不包含运行时动态生成的(比如用
e.Any()+ 条件判断绕过注册的) - 如果用了
e.Group(),Path是拼接后的完整路径(如/api/users),不是相对路径
为什么不能靠 pprof 或 /debug/pprof 查路由?
/debug/pprof 是 Go 标准库的性能分析端点,echo 默认不挂载它,即使你手动桥接了 http.DefaultServeMux,它也只暴露 goroutine、heap、profile 等运行时状态,**完全不包含任何路由注册信息**。试图通过 pprof 查接口列表会白忙一场。
- pprof 的路径匹配和 echo 路由树是两套独立系统,无交集
- echo 的路由查找走的是 Radix Tree(基数树),pprof 根本不参与也不感知
- 想确认某条路由是否存在?唯一可靠方式是看
e.Routes()输出,或发起真实 HTTP 请求测试 404
开发期快速验证路由是否生效的土办法
与其等上线后猜,不如在启动时加个健康检查路由,返回当前所有路由的精简快照:
e.GET("/_routes", func(c echo.Context) error {
routes := make([]map[string]string, 0)
for _, r := range e.Routes() {
routes = append(routes, map[string]string{
"method": r.Method,
"path": r.Path,
"name": r.Name,
})
}
return c.JSON(200, routes)
})
- 访问
http://localhost:8080/_routes就能拿到 JSON 格式列表,适合前端调试工具或 CI 脚本消费 - 注意:不要在生产环境暴露此接口,避免路由结构泄露
- 若路由量极大(>1k),建议加
--env=dev开关控制是否注册该端点
e.Routes() 仍是唯一可信来源 —— 它不撒谎,但也不会帮你补全缺失的中间件或条件分支逻辑。


















