Node.js Express路由中Cookie无法传递致认证失败问题

1. 确认是否安装并配置cookie-parser中间件 #

Express本身不会自动解析Cookie，必须依赖cookie-parser包处理请求中的Cookie数据：

• 先安装依赖：

  npm install cookie-parser
  

• 在Express主入口文件（如app.js）中配置，注意要放在所有路由注册之前：

  const cookieParser = require('cookie-parser');
  app.use(cookieParser());
  

2. 检查Cookie的设置参数是否正确 #

设置Cookie时的参数错误会导致请求无法携带Cookie到后端，重点排查以下项：

• Path：若设置了path: '/admin'这类特定路径，非该路径下的路由（如你的/deleteUser）无法获取Cookie，建议设为path: '/'让所有路由可访问。
• Domain：前后端域名/端口不同时，需将Domain设为公共域名（如本地开发设为'localhost'，不要带端口）。
• Secure/SameSite：生产环境用HTTPS时可设secure: true+sameSite: 'None'；本地HTTP开发时不要设secure: true，SameSite可设为'Lax'。

示例正确的Cookie设置代码：

res.cookie('jwt', token, {
  httpOnly: true,
  maxAge: 24 * 60 * 60 * 1000,
  path: '/',
  domain: 'localhost',
  sameSite: process.env.NODE_ENV === 'production' ? 'None' : 'Lax',
  secure: process.env.NODE_ENV === 'production'
});

3. 跨域场景下的前后端配置 #

如果前后端跨域（端口/域名不同），需同时配置前后端允许携带凭证：

• 前端请求配置：
  • 原生fetch：

    fetch('/api/deleteUser', {
      method: 'DELETE',
      credentials: 'include'
    });
    

  • Axios：

    axios.delete('/api/deleteUser', {
      withCredentials: true
    });
    

• 后端CORS配置：

  const cors = require('cors');
  app.use(cors({
    origin: 'http://localhost:3000', // 替换为你的前端域名
    credentials: true
  }));
  

4. 验证请求是否实际携带Cookie #

打开浏览器开发者工具（F12）→ 进入Network面板，找到/deleteUser请求，查看Request Headers中的Cookie字段是否包含jwt：

• 若没有Cookie字段：问题出在Cookie设置或前端请求配置；
• 若有Cookie字段但后端仍获取不到：检查cookie-parser是否正确配置在路由之前。

内容的提问来源于stack exchange，提问作者Hanne Clausen Benstruff Gummi