静态路由必须放在参数路由前面，因为Hertz路由匹配按节点类型优先级执行：静态节点（skind）> 参数节点（pkind）> 通配节点（akind），注册顺序不改变该优先级，仅影响同类型节点的匹配次序。
路由性能瓶颈通常不在业务逻辑，而在匹配过程本身——Hertz的路由树算法和注册时机直接影响QPS和P99延迟。
为什么静态路由必须放在参数路由前面
Hertz路由匹配按注册顺序逐条比对，但真正起决定性作用的是节点类型优先级：静态节点 skind > 参数节点 pkind > 通配节点 akind。即使你后注册一个 /users/:id，只要先注册了 /users/profile，请求 /users/profile 就不会回溯到参数路由。
- 错误写法：
router.GET("/users/:id", handler); router.GET("/users/profile", profileHandler)→/users/profile实际命中参数路由，id变成字符串"profile" - 正确顺序：静态路由必须显式前置，Hertz不会自动重排
- 验证方式：调用
engine.Routes()查看返回的RouteInfo列表，确认Path字段排序符合预期
如何避免路由树膨胀导致内存暴涨
大量重复前缀路径（如 /api/v1/users/...、/api/v2/users/...）会触发Hertz路由树的节点压缩失效，导致内存占用翻倍且匹配变慢。
- 用分组路由替代扁平注册：
apiV1 := router.Group("/api/v1")，再在apiV1下注册.GET("/users", ...) - 禁止在循环中动态注册路由：
for _, v := range endpoints { router.GET(v.Path, v.Handler) }→ 每次注册都新建节点，无法共享前缀 - 检查
Root节点子节点数：若单个skind下子节点超 50 个，说明该层级缺乏分组抽象
什么时候该关掉路由调试日志
debugPrintRoute 在开发期很有用，但在压测或生产环境会显著拖慢启动速度，并产生大量日志IO —— 它在每次 router.GET 调用时都做一次 runtime.FuncForPC 反射查询。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“go语言免费学习笔记（深入）”；
- 默认开启：Hertz 会在
h := server.New()时根据os.Getenv("HZ_DEBUG")自动启用 - 关闭方法：启动前设置
os.Setenv("HZ_DEBUG", "false")，或直接编译时加-tags hz_no_debug - 注意：关闭后
engine.Routes()返回的Handler字段为空字符串，仅保留函数地址，无法直接读源码位置
StaticFS 的 PathNotFound 不等于全局 404
app.FS 的 PathNotFound 是文件系统层的兜底，只捕获 StaticFS 路由内部的 404；它不会接管其他路由（如 router.GET("/api/*path", ...)）的未匹配请求。
- 常见误用：把
PathNotFound当作全局 404 中间件，结果静态资源 404 被处理了，API 路由 404 却返回空白页 - 正确做法：全局 404 必须用
router.NoRoute显式注册，且要放在所有Static*调用之后 - 性能提示：如果
PathNotFound里做了重定向或复杂模板渲染，会拖慢所有静态资源缺失请求，建议只返回简单c.String(404, "not found")
路由优化最易被忽略的一点：它不是“写完再调优”的环节，而是在第一次 router.GET 调用前就要规划好分组结构和路径命名规范——因为Hertz的路由树一旦初始化就不可变更，重构成本远高于接口设计阶段的约束。
