Express鉴权中间件Cookie接收异常：浏览器存Cookie但后端无Token

已设置Axios的withCredentials: true，浏览器中存在Token Cookie，但后端打印req.headers.token、req.cookies均为undefined，控制台输出：

undefined
[Object: null prototype] {}
undefined

可能的原因及解决办法 #

• 未配置Cookie解析中间件
  Express默认不会自动解析Cookie，必须使用cookie-parser中间件才能读取req.cookies：

  1. 安装依赖：

     npm install cookie-parser
     

  2. 在Express应用中注册中间件（需在你的auth中间件之前）：

     import cookieParser from 'cookie-parser';
     import express from 'express';
     
     const app = express();
     app.use(cookieParser());
     

• CORS配置错误
  后端必须正确配置CORS，允许携带凭证且不能使用通配符*作为Origin：

  import cors from 'cors';
  
  app.use(cors({
    origin: 'http://localhost:你的前端端口', // 比如前端运行在3001则填对应地址
    credentials: true // 允许请求携带Cookie等凭证
  }));
  

  注意：若用*作为origin，credentials: true会被浏览器忽略，导致Cookie无法发送。

• Cookie的SameSite属性不兼容跨域场景
  若前后端为跨域（如端口不同），Cookie的SameSite属性需设为None，生产环境需开启Secure（本地HTTP开发可暂时关闭）：
  设置Cookie的代码示例：

  res.cookie('token', 你的Token值, {
    httpOnly: true,
    sameSite: 'none',
    secure: process.env.NODE_ENV === 'production',
    maxAge: 24 * 60 * 60 * 1000,
    path: '/' // 确保所有路径都能携带该Cookie
  });
  

• Cookie的路径/域名设置错误
  打开浏览器开发者工具（F12），在Application -> Cookies中检查目标Cookie属性：

  • 确认Cookie的Name为token（和后端req.cookies.token对应）
  • 确认Domain为localhost（或你的后端域名），无多余前缀
  • 确认Path为/，确保所有请求路径都能携带该Cookie

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