直接在路由处理器中用c.Response().Header().Set()是最常用且可控的方式，必须在c.String()、c.JSON()等写响应方法前调用，否则因WriteHeader已触发而失效；Set()替换同名头，Add()追加；中间件统一设头需置于路由组前且避免提前响应。
直接在路由处理器里用 c.Response().Header().Set()
这是最常用也最可控的方式。Echo 的 Context 提供了对底层 http.ResponseWriter 的访问入口，c.Response().Header() 返回的是标准的 http.Header 映射，可以自由增删改。
注意：必须在调用任何写响应的方法（如 c.String()、c.JSON()、c.NoContent()）之前 设置 header，否则会被忽略——因为一旦响应头被写出（WriteHeader() 被触发），再设 header 就无效了。
- ✅ 正确顺序：
c.Response().Header().Set("X-Request-ID", reqID)→c.JSON(200, data) - ❌ 错误顺序：
c.JSON(200, data)→c.Response().Header().Set(...)（完全无效） - 如果需要覆盖已有 header（比如多个中间件都设了同一个 key），
Set()会替换，Add()会追加
用中间件为某组路由统一加 header
当多个路由共用同一套 header（比如统一加 X-Frame-Options 或 X-Content-Type-Options），用中间件比每个 handler 里重复写更安全、不易漏。
关键点是：中间件必须放在对应路由组 之前注册，且不能提前触发响应（比如不能在中间件里调用 c.String()）。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 给
/api/v1/下所有路由加X-API-Version: v1：apiV1 := e.Group("/api/v1") apiV1.Use(func(next echo.HandlerFunc) echo.HandlerFunc { return func(c echo.Context) error { c.Response().Header().Set("X-API-Version", "v1") return next(c) } }) apiV1.GET("/users", listUsers) - 中间件里不要用
c.Echo().Use()，那是全局中间件；这里用的是组级Use() - 若中间件里做了鉴权失败并直接
c.JSON(401, ...)，那 header 设置就失效了——得把 header 设置挪到return next(c)之后，或拆成前置逻辑 + 后置逻辑
为什么不能用 w.Header().Set() 在 handler 外部传参
常见错误是试图在 http.HandleFunc 风格里操作原始 http.ResponseWriter，比如：
func myHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("X-Foo", "bar") // ❌ Echo 不走这个流程
// ...
}
Echo 的 handler 签名是 func(echo.Context) error，它封装了 ResponseWriter，你拿到的 w 是原始对象，但 Echo 已接管响应生命周期。绕过 c.Response() 直接操作会导致：
- header 可能被后续 Echo 内部逻辑覆盖（比如 CORS 中间件）
- gzip 压缩、日志记录等依赖
c.Response()的功能异常 - 在启用
e.Debug = true时，header 变更不会被日志捕获
echo.HTTPError 场景下 header 设置容易被忽略
当 handler 抛出 echo.NewHTTPError(400, "bad request")，默认响应体是 JSON，但 header 是空的。这时候想加自定义 header（比如 X-Retry-After），不能靠 defer 或 panic 捕获——得用 e.HTTPErrorHandler 全局覆盖。
- 正确做法：在
e.HTTPErrorHandler = func(err error, c echo.Context)里先设 header，再调用c.JSON()或c.String() - 错误认知：以为
echo.NewHTTPError()接收 header 参数（它不接收） - 如果只针对某几个路由加 error header，建议不用
NewHTTPError，而是手动c.Response().Header().Set()+c.JSON(400, ...)
最易被忽略的一点：header 名称大小写不敏感，但值里有空格或特殊字符时，必须用双引号包裹（比如 Content-Disposition: attachment; filename="report.pdf"），而 c.Response().Header().Set() 不做自动转义，得你自己处理。
