httperrorhandler必须在e.use()和路由注册前配置，否则404/405/panic等错误将走默认处理器；需统一处理*echo.httperror及panic，返回标准json并记录日志，禁用敏感信息暴露。
错误处理必须在中间件注册前设置 HTTPErrorHandler
Echo 的 HTTPErrorHandler 是全局错误捕获入口，但它不是中间件，不能用 e.Use() 注册。必须在创建 echo.Echo 实例后、任何路由或中间件注册前就配置好，否则 404、405 或 panic 导致的错误会走默认处理器，返回 HTML 页面或空响应。
常见错误现象：加了自定义错误处理逻辑但 404 仍返回默认文本；或 c.JSON(400, ...) 正常，但结构体绑定失败（c.Bind()）却抛出原始 panic。
- 正确顺序：创建
e := echo.New()→ 设置e.HTTPErrorHandler = customHandler→ 再调用e.Use()或e.GET() - 不要试图在中间件里用
defer/recover拦截所有错误——Echo 的HTTPErrorHandler已覆盖 panic、echo.NewHTTPError、绑定失败等绝大多数场景 - 如果用了
echo.WrapHandler或第三方 net/http handler，需额外确保其错误也透传到HTTPErrorHandler
自定义 HTTPErrorHandler 要统一返回 JSON 格式
客户端依赖一致的响应结构，不能让部分错误返回 {"error": "xxx"}，另一些返回 {"code": 400, "message": "xxx"}。直接替换 e.HTTPErrorHandler 是最稳妥方式。
示例中容易忽略的是状态码映射：比如 echo.NewHTTPError(422, "invalid json") 和手动 c.String(422, "...") 都应被同一逻辑处理，而非只捕获 *echo.HTTPError 类型。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 必须检查
err是否为*echo.HTTPError，是则取he.Code和he.Message - 非
*echo.HTTPError的 panic 或其他 error，统一降级为500，且Message不暴露堆栈（生产环境禁用fmt.Sprintf("%+v", err)） - 返回前调用
c.Logger().Error(err)记录日志，但响应体不包含敏感字段（如数据库错误详情）
中间件里主动抛错要用 echo.NewHTTPError，别用 panic
在鉴权、验签、参数校验等中间件中，遇到非法请求应明确返回标准错误，而不是 panic("unauthorized")。后者会绕过 HTTPErrorHandler 的格式控制，直接触发 recovery 中间件（如果启用了）并可能泄露信息。
典型场景：签名验证失败、时间戳超差、nonce 重复。这些本该是 401/403，但若用 panic，最终响应可能是 500 + HTML，和业务约定不符。
- 统一用
return echo.NewHTTPError(http.StatusUnauthorized, "invalid signature") - 避免
c.JSON(401, ...)+return nil—— 这样错误不会进入HTTPErrorHandler，无法被统一日志或监控捕获 - 如果中间件需提前终止流程且不希望后续中间件执行，必须用
return显式退出，不能只写c.JSON
recover 中间件和 HTTPErrorHandler 的分工要清晰
Echo 自带的 echo.MiddlewareFunc(recover.Recover()) 仅负责捕获 panic 并转成 *echo.HTTPError(500)，它本身不生成响应体。真正决定「返回什么内容」的是 HTTPErrorHandler。
很多人把 recover 当作错误处理全部，结果导致 400 类错误没走统一格式，而 panic 却被双重重写。这是典型的职责混淆。
- 启用
recover中间件仅用于兜底：防止未预期 panic 崩溃进程 -
HTTPErrorHandler才是唯一响应构造点：所有错误（包括 recover 转来的）都经它输出 - 不要在
HTTPErrorHandler里再调用recover或嵌套defer—— 它本身已是错误终点
Bind 解析结构体失败时，Echo 默认返回 400 Bad Request 文本，但这个错误对象是 *echo.HTTPError，且 Message 是 raw error 字符串（如 "Key: 'User.Age' Error:Field validation for 'Age' failed on the 'min' tag"）。你得在 HTTPErrorHandler 里识别这类消息并做清洗，否则前端无法解析。
