前端未接收后端Cookie问题排查（NestJS/NextJS部署场景）

核心结论 #

Nginx配置或后端代理信任设置确实可能导致该问题，以下是具体排查思路：

1. 先定位问题出在后端还是Nginx #

直接通过curl请求后端接口，确认后端是否返回Set-Cookie：

curl -v https://backend.exampleurl.com/你的认证接口路径

• 如果响应头中没有Set-Cookie：问题出在后端逻辑或配置，跳过Nginx相关排查；
• 如果响应头中有Set-Cookie：问题出在Nginx的转发配置，继续下一步。

2. 检查NestJS的代理信任配置（最常见原因） #

线上是Nginx反向代理，后端默认不会信任代理传递的协议头，会认为请求是HTTP协议。而你的Cookie配置了secure: true（仅HTTPS请求才会发送Cookie），此时session中间件会跳过Set-Cookie的设置。

解决方法：在NestJS的main.ts中添加代理信任配置：

// 在app.use(session(...))之前或之后添加
app.enable('trust proxy');
// 或者更明确的配置
// app.set('trust proxy', true);

重启后端服务后重新测试。

3. 验证Nginx对Set-Cookie的转发 #

• 检查Nginx全局配置或当前location中是否存在proxy_hide_header Set-Cookie;，如果有，立即删除该配置；
• 你当前配置的proxy_pass_header Set-Cookie;其实是冗余的（Nginx默认会转发Set-Cookie），可以尝试删除该行后重启Nginx测试；
• 开启Nginx的详细日志，确认是否接收到后端的Set-Cookie并转发给前端：
  在Nginx配置中添加自定义日志格式：

  log_format detailed '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$sent_http_set_cookie"';
  

  然后在对应的server块中修改access_log：

  access_log /var/log/nginx/backend_access.log detailed;
  

  访问接口后查看日志，$sent_http_set_cookie字段如果为空，说明Nginx没转发Set-Cookie；如果有内容，说明前端接收环节有问题（但本地正常的话概率极低）。

4. 核对Cookie配置细节 #

• 确认domain: '.exampleurl.com'拼写完全正确，线上前后端域名确实属于该主域（比如没有写成.exampleurl.co或多打/少打点）；
• 确认sameSite: 'none'与secure: true同时存在，这是SameSite=None的强制要求，你的配置已经满足，但需确保后端识别到请求是HTTPS（对应步骤2的配置）。

5. 排查Session初始化逻辑 #

你的session配置了saveUninitialized: false，意味着只有当session被主动修改时（比如认证成功后给req.session赋值用户信息），才会生成并发送Set-Cookie。确认认证接口中存在类似req.session.user = userInfo的逻辑，避免因未修改session导致无Set-Cookie返回。

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