KrakenD中http-client插件设置Cookie无法返回客户端问题排查

1. 检查KrakenD响应头透传配置 #

KrakenD默认会过滤非标准响应头，需显式配置允许Set-Cookie传递到客户端。在API端点配置中，通过output_headers指定允许的头，或直接开启allow_all_headers：

{
  "endpoint": "/your-api-path",
  "extra_config": {
    "github.com/devopsfaith/krakend-http-client": {
      "return_error_details": true
    },
    "github.com/devopsfaith/krakend-ce": {
      "output_headers": ["Set-Cookie"],
      "allow_all_headers": false
    }
  },
  "backend": [
    // 你的后端配置
  ]
}

生产环境建议显式指定头，测试场景可直接设allow_all_headers: true简化配置。

2. 验证插件Cookie设置逻辑 #

确保插件在后端响应阶段修改响应头，而非请求阶段。以下是Go语言插件的正确实现片段：

func (p *Plugin) ClientHTTP(cfg *config.Backend) (*http.Client, error) {
    client, err := httpclient.NewHTTPClient(cfg)
    if err != nil {
        return nil, err
    }
    originalTransport := client.Transport
    client.Transport = &roundTripper{rt: originalTransport}
    return client, nil
}

type roundTripper struct {
    rt http.RoundTripper
}

func (rt *roundTripper) RoundTrip(req *http.Request) (*http.Response, error) {
    resp, err := rt.rt.RoundTrip(req)
    if err != nil {
        return resp, err
    }
    // 向响应头添加Cookie
    resp.Header.Add("Set-Cookie", "custom-cookie=demo-value; Path=/; HttpOnly; Secure")
    return resp, err
}

重点：必须修改响应对象的Header，若仅在请求阶段添加Cookie，只会传递给后端，不会返回给客户端。

3. 检查全局头过滤规则 #

查看KrakenD全局配置，确保headers_to_remove未包含Set-Cookie，同时headers_to_pass未限制该头的传递。

4. 验证curl命令正确性 #

要看到响应头中的Cookie，必须添加-i（或--include）参数显示响应头，正确命令示例：

curl -i http://your-krakend-host/your-api-path

未加-i时，curl默认仅显示响应体，自然无法看到Set-Cookie头。

5. 排查中间件拦截 #

若配置了CORS、限流等中间件，检查其是否会修改/移除Set-Cookie头。例如CORS中间件无需将Set-Cookie加入exposed_headers（属于特殊头），但需确认中间件无强制过滤逻辑。

6. 日志调试定位 #

开启KrakenD DEBUG级日志，确认响应头是否被正确生成：

{
  "extra_config": {
    "github.com/devopsfaith/krakend-gologging": {
      "level": "DEBUG",
      "prefix": "[KRAKEND]",
      "stdout": true
    }
  }
}

启动后查看日志中的响应头输出：

• 若日志存在Set-Cookie但curl看不到：排查KrakenD前端的反向代理/网关配置
• 若日志无Set-Cookie：确认插件逻辑或端点配置未生效

内容的提问来源于stack exchange，提问作者Rabmam