Swagger Editor为何不发送Cookie请求头？Cookie认证场景异常排查

这个问题我之前也碰到过！核心原因是你的OpenAPI定义里没有明确声明Cookie认证的安全机制——Swagger Editor的「Try it out」功能需要明确的配置指令，才知道要在请求中携带Cookie；而curl能正常执行是因为你手动指定了Cookie请求头，和Swagger UI的逻辑完全不一样。

下面是具体的修复步骤：

1. 添加Cookie认证的安全方案定义 #

在你的OpenAPI根节点下新增components字段，声明Cookie类型的安全认证规则：

openapi: 3.0.0
servers:
  - url: 'XXXXXXX'
info:
  description: xxxxx
  version: 1.0.0
  title: xxxxx
  contact:
    email: xxxxxx
# 新增Cookie认证的安全方案配置
components:
  securitySchemes:
    CookieAuth:  # 自定义认证方案名称，可按需修改
      type: apiKey
      in: cookie
      name: YOUR_COOKIE_NAME  # 替换成你实际使用的Cookie键名，比如session_token
# 原有的paths部分保持不变
paths:
  '/tenants/{tenant_id}/call/projects':
    get:
      tags:
        - project
      operationId: getProjects
      parameters:
        - name: tenant_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success...

2. 为接口启用Cookie认证 #

你可以根据需求选择两种启用方式：

全局启用（所有接口自动携带Cookie） #

在info字段下方添加全局安全要求：

info:
  description: xxxxx
  version: 1.0.0
  title: xxxxx
  contact:
    email: xxxxxx
# 全局配置，所有接口都会使用CookieAuth认证
security:
  - CookieAuth: []

单个接口启用（仅指定接口生效） #

在目标接口的配置里添加security字段：

paths:
  '/tenants/{tenant_id}/call/projects':
    get:
      tags:
        - project
      operationId: getProjects
      # 仅当前接口启用Cookie认证
      security:
        - CookieAuth: []
      parameters:
        - name: tenant_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success...

3. 验证效果 #

配置完成后刷新Swagger Editor，再用「Try it out」发送请求，就能看到请求头里自动带上对应的Cookie了。如果是跨域场景，可能需要确保你的服务器允许Swagger Editor所在域名携带Cookie（比如配置Access-Control-Allow-Credentials: true），不过既然curl能正常执行，大概率域名是匹配的，这一步可能不需要额外调整。

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