Symfony 6 API与Vue集成时PUT/PATCH请求CORS异常排查求助

• 环境：Symfony 6 构建的 REST API + Vue 前端，使用 NelmioCorsBundle 处理跨域，JWT Bundle 做身份认证，部署依赖 Docker + Nginx
• 异常症状：
  1. 未配置 allow_origin 时，仅 PUT/PATCH 请求失败，报错：

  Access to XMLHttpRequest at 'http://localhost:8080/api/listing' from origin 'http://localhost:5173' has been blocked by CORS policy: Method PUT is not allowed by Access-Control-Allow-Methods in preflight response.
  

  2. 添加 allow_origin: ['*'] 后，所有请求均失败，报错：

  Access to XMLHttpRequest at 'http://localhost:8080/api/category' from origin 'http://localhost:5173' has been blocked by CORS policy: The 'Access-Control-Allow-Origin' header contains multiple values 'http://localhost:5173, *', but only one is allowed.
  

1. 修正 NelmioCorsBundle 配置 #

确保配置覆盖预检请求、自定义头部，且避免冲突：

# config/packages/nelmio_cors.yaml
nelmio_cors:
    defaults:
        origin_regex: true
        allow_origin: ['^http://localhost:5173$'] # 精确匹配前端地址，禁止同时混用*和具体域名
        allow_methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'] # 必须包含OPTIONS（预检请求方法）
        allow_headers: ['Content-Type', 'Authorization'] # 包含JWT所需的Authorization头
        expose_headers: ['Authorization']
        max_age: 3600 # 缓存预检结果，减少重复请求
    paths:
        '^/api/': ~ # 仅对API路径应用CORS规则

2. 移除 Nginx 中手动添加的 CORS 头 #

若 Docker 中的 Nginx 配置手动添加了 Access-Control-Allow-Origin，会与 NelmioCorsBundle 的头冲突，需删除类似配置：

# 移除该行配置
add_header Access-Control-Allow-Origin *;

让 NelmioCorsBundle 全权处理跨域头，Nginx 仅负责反向代理。

3. 确保 JWT 放行 OPTIONS 预检请求 #

预检请求（OPTIONS）不会携带 Authorization 头，需在 security.yaml 中放行：

# config/packages/security.yaml
security:
    firewalls:
        api:
            pattern: ^/api/
            stateless: true
            jwt: ~
            access_control:
                - { path: ^/api/, methods: [OPTIONS], roles: IS_AUTHENTICATED_ANONYMOUSLY } # 允许OPTIONS无需认证
                - { path: ^/api/, roles: IS_AUTHENTICATED_FULLY }

4. 验证 Axios 请求配置 #

确保请求头正确，无需额外跨域配置：

// PUT 请求示例
axios.put('http://localhost:8080/api/listing', 
  { /* 请求数据 */ },
  {
    headers: {
      'Authorization': 'Bearer ' + token,
      'Content-Type': 'application/json'
    }
  }
)

5. 清理缓存并重启服务 #

修改配置后需清理 Symfony 缓存，若用 Docker 则重启容器：

# 开发环境
php bin/console cache:clear
# 生产环境
php bin/console cache:clear --env=prod

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