Express框架下调用res.cookie无法设置Cookie问题求助

一、故障排查步骤 #

• 检查res.cookie调用后是否正常返回响应：res.cookie仅会将Set-Cookie标识写入响应对象，必须后续调用res.send()/res.json()/res.end()等方法向客户端返回完整响应，Cookie才会生效。如果req.login执行后没有后续响应返回逻辑，或是中间出现了响应被重置、提前返回的代码，都会导致Cookie丢失。
• 检查跨域场景下的配套配置：如果前端和后端接口的域名、端口、协议任意一项不一致，属于跨域请求，必须同时满足三个条件：
  1. 服务端CORS配置开启credentials: true
  2. 前端发起请求时开启携带凭证配置：axios设置withCredentials: true，fetch请求设置credentials: 'include'
  3. 调整Cookie属性适配浏览器策略：HTTPS生产环境需要补充sameSite: 'None' + secure: true；本地HTTP开发环境设置sameSite: 'Lax'即可，不要开启secure属性，否则HTTP场景下带secure标识的Cookie会被浏览器直接拒收。
• 检查Domain配置是否匹配：如果手动指定了Cookie的domain字段，需要确保值和接口请求的域名完全匹配，没有特殊需求不建议手动配置该字段，默认会自动匹配当前接口域名。
• 检查响应头是否存在Set-Cookie字段：打开浏览器控制台「网络」面板，找到对应接口请求，查看响应头是否存在Set-Cookie: jwt=xxx字段：如果存在但浏览器未存储，属于浏览器安全策略拦截，对应调整上述跨域、Cookie属性配置即可；如果不存在该字段，属于服务端逻辑问题，优先检查cookieParser中间件是否注册在路由之前、res对象是否被后续逻辑覆盖。

二、适配多环境的代码示例 #

req.login = (user) => {
    const token = createJWTToken({ user });
    console.log(token);
    const isProdHttps = process.env.NODE_ENV === 'production';
    res.cookie('jwt', token, { 
      maxAge: 1000 * 60 * 15, // 15分钟后过期
      httpOnly: true, // 该Cookie仅允许Web服务端访问
      sameSite: isProdHttps ? 'None' : 'Lax',
      secure: isProdHttps
    });
    req.user = user;
    // 此处必须补充返回响应的逻辑，示例：
    // return res.json({ code: 0, msg: '登录成功', data: user })
};

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