c.JSON(404, ...)不触发HTTPErrorHandler，因其仅为合法响应而非错误信号；HTTPErrorHandler仅捕获*echo.HTTPError和未处理panic，需显式调用c.Error(echo.NewHTTPError(http.StatusNotFound, ...))才能进入全局错误处理流程。
为什么 c.JSON(404, ...) 不触发全局错误处理器
Echo 的 HTTPErrorHandler 不会捕获你手动写的 c.JSON(404, ...)、c.String(404, ...) 或 c.NoContent(404) —— 这些只是合法响应，不是错误信号。它只响应两类情况：*echo.HTTPError 实例，以及未被 handler 捕获的 panic（前提是启用了 middleware.Recover()）。如果你希望 404 走统一错误处理逻辑（比如记录日志、统一样式返回），必须显式调用 c.Error()。
- 错误写法：
c.JSON(404, map[string]string{"error": "not found"})→ 绕过HTTPErrorHandler，不记录日志，也不受开发/生产环境差异化控制 - 正确写法：
c.Error(echo.NewHTTPError(http.StatusNotFound, "user not found"))→ 自动被HTTPErrorHandler捕获，he.Code和he.Message可直接提取 - 别漏掉
echo.NewHTTPError构造：直接c.Error(fmt.Errorf("..."))会走默认 500 分支，无法区分业务 404
如何让未匹配路由自动返回 404 并进入 HTTPErrorHandler
Echo 默认不会为未注册路径自动返回 404；它会直接报 code=404, message="Not Found"，但这个 404 是框架底层硬编码的字符串响应，不经过你的 HTTPErrorHandler。要让它进，得在路由末尾加一个兜底 handler。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 在所有
e.GET/e.POST等路由注册之后，加：e.Any("/*", func(c echo.Context) error { return c.Error(echo.NewHTTPError(http.StatusNotFound, "route not found")) }) - 注意用
e.Any而非e.GET，否则 OPTIONS、PUT 等方法仍会 404 且绕过错误处理器 - 这个兜底必须放在最后——如果前面有
e.GET("/*", ...)这类宽泛路由，它会提前匹配，导致真实业务路由被遮蔽
HTTPErrorHandler 中怎么安全处理 404 日志和响应
404 是高频状态，日志不能照搬原始错误信息，响应内容也不能暴露路径细节。尤其当 HTTPErrorHandler 同时处理 404 和 500 时，需明确区分对待。
- 不要直接
c.JSON(code, map[string]interface{}{"message": err.Error()})→ 可能泄露/var/www/app/internal/...这类路径 - 对 404 建议固定文案：
message := "Resource not found"，不拼接he.Message，除非你白名单校验过其内容 - 日志必须保留原始路径：
c.Logger().Errorf("404: %s | path=%s method=%s", err.Error(), c.Request().URL.Path, c.Request().Method) - 开发环境可额外打印
c.Request().Referer()或c.Get("user_id")（如果有），方便定位是前端跳转错还是爬虫乱扫
Nginx 配合 Echo 时，真正的 404 可能根本没到 Go 层
如果你在 Nginx + Echo 部署中看到 404，先确认它是 Nginx 返回的（查看响应头 Server: nginx），还是 Echo 返回的（Server: echo）。前者说明请求压根没进 Go 进程，后者才是框架层问题。
- 检查 Nginx 的
location /api/ { proxy_pass http://backend/; }是否末尾带/→ 缺少会导致/api/users被转发成/api/users（而非/users），后端无匹配路由，Echo 返回 404 - 静态资源路径如
/static/被 Nginx 截断后，若配置了try_files $uri @backend;却没定义@backend，Nginx 会自己返回 404，Go 完全不知情 - 用
curl -v http://your.domain/api/xxx看响应头，这是最快判断 404 发生在哪一层的方式
