直接返回指定状态码应使用c.NoContent()、c.String()或c.JSON()等原生方法，避免echo.NewHTTPError()触发错误处理器；重定向必须用c.Redirect()；动态状态码需白名单校验。
直接返回指定状态码用 c.NoContent() 或 c.String()
不需要绕路写中间件或自定义错误处理器——Echo 提供了最直白的响应方式。比如你想让某个路由固定返回 404，就别 return echo.NewHTTPError(404)，那会走错误处理流程，还可能被全局 HTTPErrorHandler 拦截改写。
推荐做法是直接调用原生响应方法：
-
c.NoContent(http.StatusNotFound)：返回空体 + 指定状态码，适合 HEAD 或纯状态反馈场景 -
c.String(http.StatusTeapot, "I'm a teapot")：带文本体，状态码可任意（比如418） -
c.JSON(http.StatusLocked, map[string]string{"error": "resource locked"})：结构化响应，状态码由你控制
这些方法跳过错误链，不触发 HTTPErrorHandler，也不做额外日志（除非你自己加），干净利落。
echo.NewHTTPError() 适合需要统一错误格式的场景
当你希望所有 4xx/5xx 响应都走同一套 JSON 格式（比如 {"error": "...", "code": 400}），才该用 echo.NewHTTPError()。它本质是 panic 一个带状态码的 error，再被 HTTPErrorHandler 捕获。
常见误用：
- 在 handler 里写
return echo.NewHTTPError(400)却没配HTTPErrorHandler→ 返回空白页 + 400，但无 body - 配了
HTTPErrorHandler却在里面硬编码了500→ 所有错误都被抹成 500，丢失原始状态码
正确写法示例（保留原始状态码）：
func customHTTPErrorHandler(err error, c echo.Context) {
code := http.StatusInternalServerError
message := "Internal Server Error"
if he, ok := err.(*echo.HTTPError); ok {
code = he.Code
message = he.Message
}
c.JSON(code, map[string]interface{}{"error": message, "code": code})
}
e.HTTPErrorHandler = customHTTPErrorHandler
重定向类状态码用 c.Redirect()，别手拼 http.Redirect()
像 301、302、307 这种重定向状态码，必须用 c.Redirect()，不要自己调 http.Redirect() 或设 header + status。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
原因：c.Redirect() 会自动设置 Location header，并确保 response body 为空（RFC 要求），且兼容 Echo 的中间件生命周期（比如日志中间件能记录完整跳转）。
c.Redirect(http.StatusMovedPermanently, "/new-path")-
c.Redirect(http.StatusTemporaryRedirect, "https://example.com")（支持绝对 URL）
如果手动写 c.Response().Header().Set("Location", ...) 再 c.Response().WriteHeader(...)，容易漏清 body、破坏中间件上下文，测试时可能表现正常，上线后在某些代理后出问题。
动态状态码要防注入，别直接透传 query 参数
有人为了调试方便，想通过 ?status=418 动态控制返回码。这很危险——没校验就直接传给 c.String(status, ...)，可能被构造为 status=999 或负数，导致 Go 的 http.Error() panic。
必须白名单校验：
statusStr := c.QueryParam("status")
status, err := strconv.Atoi(statusStr)
if err != nil || status 599 || !isValidStatus(status) {
status = http.StatusOK
}
c.String(status, "dynamic response")
其中 isValidStatus() 应只放真实常用码（如 200/201/204/400/401/403/404/429/500/503），别图省事用范围判断。HTTP 状态码不是连续整数集，很多值未定义或已废弃。
状态码不是装饰品，它参与客户端缓存、重试、错误分类等关键逻辑。配置错一个 302 和 307，前端重定向时可能丢 POST body；返回 200 却塞个错误 JSON，会让 axios 的 response.data 解析成功但业务失败。别让它变成“看起来对”的陷阱。
