必须显式构造路由元数据结构，不能靠反射自动发现；Echo 的 router 字段未导出，反射无法访问，强行读取会导致崩溃，推荐在注册路由时同步构建 RouteInfo 切片。
不能靠反射自动发现路由，必须显式构造元数据结构
Echo 框架本身不提供运行时路由扫描或自动导出功能。所谓“自动导出”，其实是你在注册路由时，同步维护一份结构化的路由清单（比如 []RouteInfo），而不是事后用反射去翻 Echo 内部的 e.router.routes —— 那些字段是 unexported 的，反射读不到，强行用 unsafe 或私有字段访问会随 Echo 版本升级直接崩。
为什么不能用 reflect.ValueOf(e).FieldByName("router") 提取路由表
常见错误是试图反射 Echo 实例获取内部路由树：
- Echo 的
router字段是小写开头（router *Router），reflect.Value.FieldByName("router")返回 zero value，调用.Interface()会 panic - 即使绕过导出限制（如用
unsafe），*Router的routes字段也是 map 类型且键为内部 hash 值，无法还原原始路径和 handler 名 - 第三方中间件（如
echo-swagger）也从不反射 Echo 实例，而是要求你手动传入echo.Group或重复定义路由信息
推荐做法：注册时同步构建 RouteInfo 切片
在调用 e.GET、e.POST 等方法的同时，往一个全局或包级变量追加结构体。这样既轻量又可控，还能带注释、标签、权限等额外字段：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
type RouteInfo struct {
Method string
Path string
Handler string // 如 "userHandler"
Tags []string
}
<p>var Routes = make([]RouteInfo, 0)</p><p>func init() {
e := echo.New()
Routes = append(Routes, RouteInfo{
Method: "GET",
Path: "/users",
Handler: "listUsers",
Tags: []string{"user", "public"},
})
e.GET("/users", listUsers)
}
- 避免在 handler 函数体内用
runtime.FuncForPC反推函数名——不可靠，交叉编译后符号可能被 strip - 如果用分组路由（
g := e.Group("/api")），记得把g.Prefix和子路径拼起来，别漏掉前缀 - 需要支持 OpenAPI 导出？直接遍历
Routes生成 YAML/JSON 即可，不用碰 Echo 底层
用 struct tag + 方法注册替代硬编码字符串
更进一步，把路由声明收口到结构体上，用 reflect 读取其方法和 tag，但注意：这仍是「显式注册」，不是「自动发现」：
type UserAPI struct{}
<p>func (u UserAPI) List(c echo.Context) error { /<em> ... </em>/ }
func (u UserAPI) Create(c echo.Context) error { /<em> ... </em>/ }</p><p>// 在 init() 中：
api := UserAPI{}
t := reflect.TypeOf(api)
v := reflect.ValueOf(api)
for i := 0; i < t.NumMethod(); i++ {
m := t.Method(i)
if routeTag := m.Tag.Get("route"); routeTag != "" {
// 解析 routeTag，如 <code>method:GET,path:/users</code>
Routes = append(Routes, parseRouteTag(m.Name, routeTag))
e.Add(strings.Split(routeTag, ",")[0], "/"+m.Name, v.Method(i).Func)
}
}
- 必须确保方法是导出的（首字母大写），否则
reflect.Type.Method()拿不到 - tag 解析要手动处理空格和分隔符，别依赖
structtag库去解析非标准 tag（Echo 不认它） - 这种写法只适合中小型项目；大型服务仍建议用独立 API 定义文件（如 Protobuf + gRPC-Gateway）驱动路由生成
真正容易被忽略的是：所有这些元数据导出逻辑，必须和路由注册严格保持顺序一致。一旦某条路由注册了但没进 Routes 切片，文档就跟实际行为脱节——这种错没法靠测试覆盖，只能靠代码审查或 CI 阶段校验切片长度与注册次数是否相等。
