Docker环境下NextJS无法存储Symfony后端Http-only Cookie问题排查

核心问题 #

浏览器未存储Http-only Cookie的根源是Cookie的Domain属性与前端页面域名不匹配，加上Docker环境下服务间调用的域名差异，导致浏览器拒绝存储Cookie。以下是具体排查点和修复方案：

1. 修复Cookie的Domain、Secure、SameSite属性配置 #

后端设置Cookie时，必须确保属性与前端页面域名匹配：

• Domain设为前端页面的根域名domain.test（而非Docker容器服务名）
• Secure设为true（HTTPS环境下必填）
• SameSite设为Lax（同域名跨端口场景适用，跨域场景需改为None并配合Secure）

在Symfony的LexikJWT配置文件（config/packages/lexik_jwt_authentication.yaml）中修改：

lexik_jwt_authentication:
    # 其他原有配置...
    token_extractors:
        cookie:
            enabled: true
            name: JWTToken
    set_cookies:
        JWTToken:
            path: /
            domain: 'domain.test'
            secure: true
            httpOnly: true
            sameSite: 'lax'

2. 确保NelmioCors允许Credentials并配置正确Origin #

检查config/packages/nelmio_cors.yaml，必须开启凭证允许，并将前端完整域名加入允许列表：

nelmio_cors:
    defaults:
        allow_credentials: true
        allow_methods: ['GET', 'OPTIONS', 'POST', 'PUT', 'PATCH', 'DELETE']
        allow_headers: ['Content-Type', 'Authorization']
        max_age: 3600
    paths:
        '^/api/':
            allow_origin: ['https://domain.test:3000']
            allow_methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS']
            allow_credentials: true

3. 解决Docker服务间调用的域名映射问题 #

NextJS通过容器服务名访问后端会导致后端Host头异常，进而影响Cookie Domain生成。需在Docker Compose中配置extra_hosts让容器识别domain.test：

# docker-compose.yml
services:
  backend:
    # 其他原有配置...
    extra_hosts:
      - "domain.test:127.0.0.1"
  frontend:
    # 其他原有配置...
    extra_hosts:
      - "domain.test:127.0.0.1"

同时修改NextJS环境变量NEXT_PUBLIC_API_URL为https://domain.test，确保前后端请求域名一致。

4. 验证前端withCredentials配置 #

确认apiClient全局或请求级已开启凭证携带：

// 全局配置（Axios示例）
const apiClient = axios.create({
  baseURL: process.env.NEXT_PUBLIC_API_URL,
  withCredentials: true
});

// 或请求级单独配置
await apiClient.post('/authentication', { email, password }, { withCredentials: true });

验证步骤 #

1. 重启Docker容器与前后端服务
2. 调用登录接口后，通过浏览器DevTools → Application → Cookies，检查https://domain.test下是否存在JWTToken
3. 查看响应头Set-Cookie，确认Domain、Secure、SameSite属性与配置一致

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