Fiber框架怎么用中间件动态修改响应头信息-Golang-PHP中文网

最稳妥的方式是在中间件中直接调用 ctx.response().header.set() 或 .add() 设置响应头，必须在 write() 或 writeheader() 调用前执行；动态值应先存 c.locals，最后统一注入；静态头优先使用 app.settings.serverheader 或全局 app.use；注意与 cors、压缩等内置中间件的执行顺序。

fiber框架怎么用中间件动态修改响应头信息

中间件里直接操作 `ctx.Response()` 是最稳妥的方式

Fiber 框架的中间件中修改响应头，不能靠返回值或装饰器式链式调用，必须显式调用 ctx.Response().Header.Set() 或 .Add()。这是由 Fiber 的底层封装决定的：它复用了 net/http 的 http.ResponseWriter 接口，而该接口要求在 Write() 或 WriteHeader() 被调用前设置响应头，否则会 panic 或静默失效。

常见错误现象包括：

调用 ctx.Status(200).JSON(...) 后再设 header —— 此时 WriteHeader() 已触发，header 会被忽略
用 ctx.Set("X-Header", "val") —— 这个方法只对后续 ctx.JSON() 等快捷方法生效，不作用于原始响应头，且不支持重复 key（如多个 Set-Cookie）

正确做法是统一在中间件开头或结尾（但必须在业务 handler 执行完、且未写响应体前）操作原生 Response：

app.Use(func(c *fiber.Ctx) error {
    // ✅ 安全：此时响应尚未写出
    c.Response().Header.Set("X-Frame-Options", "DENY")
    c.Response().Header.Set("X-Content-Type-Options", "nosniff")
    c.Response().Header.Add("Strict-Transport-Security", "max-age=31536000; includeSubDomains")

    return c.Next() // 继续执行后续 handler
})

需要动态注入值？用 `c.Locals` + `ctx.Response()` 组合

如果响应头值依赖路由参数、用户身份或请求上下文（比如 X-Request-ID 需要从 trace ID 生成），不要在中间件里提前写死 header，而是先存到 c.Locals，等 handler 执行完、准备写响应前再统一注入。

原因：Fiber 的中间件顺序执行，但 handler 可能提前终止（如 c.SendStatus(401)），此时你无法预知是否该写某个 header；而 c.Locals 是 request-scoped 的内存存储，安全可靠。

示例场景：

为每个请求生成唯一 X-Request-ID
根据登录用户角色添加 X-User-Role
灰度环境标记 X-Env

实操建议：

// 中间件1：生成并存入 locals
app.Use(func(c *fiber.Ctx) error {
    reqID := uuid.New().String()
    c.Locals("req_id", reqID)
    return c.Next()
})

// 中间件2：最后统一写 header（必须放在所有业务中间件之后）
app.Use(func(c *fiber.Ctx) error {
    if reqID, ok := c.Locals("req_id").(string); ok {
        c.Response().Header.Set("X-Request-ID", reqID)
    }
    if role, ok := c.Locals("user_role").(string); ok {
        c.Response().Header.Set("X-User-Role", role)
    }
    return c.Next()
})