本文旨在帮助开发者解决在使用 Express 中间件时，req.cookies 返回空对象，导致无法访问 Cookie 的问题。通过正确配置 cookie-parser 中间件，确保 Cookie 能够被 Express 应用正确解析和访问，从而实现用户身份验证等功能。

在使用 Express 构建后端应用时，我们经常需要通过 Cookie 来存储用户身份信息或跟踪用户行为。cookie-parser 中间件可以方便地解析 HTTP 请求中的 Cookie，并将它们添加到 req.cookies 对象中，以便在路由处理程序和中间件中访问。然而，有时我们可能会遇到 req.cookies 返回空对象，导致无法获取 Cookie 值的情况。这通常是因为 cookie-parser 中间件没有正确配置。

要解决这个问题，需要确保以下步骤：

1. 安装 cookie-parser：

   首先，确保已经安装了 cookie-parser 模块。如果没有安装，可以使用 npm 或 yarn 进行安装：

   npm install cookie-parser
   # 或者
   yarn add cookie-parser

2. 引入并使用 cookie-parser 中间件：

   在你的 Express 应用中，需要引入 cookie-parser 模块，并将其作为中间件添加到应用中。这通常在你的 app.js 或 server.js 文件中完成：

   const express = require('express');
   const cookieParser = require('cookie-parser');
   
   const app = express();
   
   // 使用 cookie-parser 中间件
   app.use(cookieParser());
   
   // 路由处理程序
   app.get('/is-auth', (req, res) => {
     console.log('Cookies: ', req.cookies); // 访问 Cookie
     res.send('Auth check');
   });
   
   app.listen(3000, () => {
     console.log('Server is running on port 3000');
   });

   注意： app.use(cookieParser()) 必须在定义任何路由之前调用，否则 req.cookies 将无法正确解析 Cookie。

3. 验证 Cookie 的设置：

   

   java-api-doc-generator

   分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

   下载

   确保在设置 Cookie 时，设置了正确的选项。尤其需要关注以下几点：

   • httpOnly: 如果设置为 true，则 Cookie 只能通过 HTTP 请求访问，无法通过 JavaScript 访问。这可以提高安全性，防止 XSS 攻击。
   • secure: 如果你的应用部署在 HTTPS 环境中，建议将 secure 设置为 true，以确保 Cookie 只能通过 HTTPS 连接传输。
   • sameSite: 用于控制 Cookie 在跨站点请求中的行为。常见的取值有 strict、lax 和 none。如果前端和后端位于不同的域名下，可能需要将 sameSite 设置为 none，并同时设置 secure: true。
   • domain: 指定 Cookie 的作用域。如果未指定，则默认为设置 Cookie 的域名。
   • path: 指定 Cookie 的路径。如果未指定，则默认为设置 Cookie 的路径。

   示例：

   res.cookie('authToken', jwToken, {
     httpOnly: true,
     secure: true, // 仅在 HTTPS 环境下有效
     sameSite: 'none', // 允许跨站点请求
     domain: '.example.com', // 指定 Cookie 的作用域
     path: '/', // 指定 Cookie 的路径
   });

4. CORS (跨域资源共享) 配置：

   如果你的前端和后端位于不同的域名下，需要配置 CORS，以允许前端向后端发送 Cookie。可以使用 cors 中间件来简化 CORS 配置：

   npm install cors
   # 或者
   yarn add cors

   const cors = require('cors');
   
   app.use(cors({
     origin: 'https://your-frontend-domain.com', // 允许的来源
     credentials: true // 允许发送 Cookie
   }));

   注意： 在 cors 中间件中，必须设置 credentials: true，才能允许前端发送 Cookie。同时，前端也需要在请求中设置 withCredentials: true。

5. 调试技巧：

   • 使用浏览器的开发者工具检查请求头和响应头，确认 Cookie 是否正确设置和发送。
   • 在中间件中添加日志，打印 req.headers.cookie 的值，查看原始 Cookie 字符串。
   • 确保你的浏览器没有禁用 Cookie。

总结：

解决 Express 中间件无法访问 Cookie 的问题，关键在于正确配置 cookie-parser 中间件，并确保 Cookie 的设置选项和 CORS 配置正确。通过仔细检查以上步骤，你应该能够成功访问 Cookie，并实现用户身份验证等功能。