如何解决Express应用解析请求头Cookie时的TypeError问题

使用Express配置cookieParser解析请求头Cookie时，通过Postman发送请求出现如下错误：

TypeError: Cannot read properties of undefined (reading 'user')

相关代码片段：

app.use(cookieParser("12345-67890-09876-54321"));

function auth(req, res, next) {
  console.log(req.headers);
  var authHeader = req.headers.authorization;
  if (!authHeader) {
    var err = new Error("You are not authenticated!");
    res.setHeader("WWW-Authenticate", "Basic");
    err.status = 401;
    next(err);
    return;
  }
  var auth = new Buffer.from(authHeader.split(" ")[1], "base64")
    .toString()
    .split(":");
  var user = auth[0];
  var pass = auth[1];
  if (user == "admin" && pass == "password") {
    if (!req.signedCookies.user) { // 报错位置
      res.cookie("user", "admin", { signed: true });
    }
    next(); // authorized
  } else {
    var err = new Error("You are not authenticated!");
    res.setHeader("WWW-Authenticate", "Basic");
    err.status = 401;
    next(err);
  }
}

原因分析 #

报错本质是req.signedCookies为undefined，导致无法读取其user属性，常见触发原因：

• 中间件顺序错误：cookieParser中间件挂载在auth中间件之后，请求先经过auth时，Cookie还未被解析，req.signedCookies未初始化。
• cookie-parser版本问题：旧版本的cookie-parser在无签名Cookie时可能返回undefined而非空对象。
• 请求未携带Cookie：首次请求时客户端无Cookie，但这种情况通常req.signedCookies是空对象而非undefined，优先排查中间件顺序。

解决方案 #

1. 调整中间件执行顺序 #

Express中间件按挂载顺序执行，必须保证cookieParser先处理请求，确保req.signedCookies被初始化。将cookieParser的挂载放在auth中间件之前：

// 先挂载cookieParser
app.use(cookieParser("12345-67890-09876-54321"));

// 再挂载auth中间件（全局或路由级别）
app.use(auth);
// 或在特定路由中使用
app.get('/protected', auth, (req, res) => {
  res.send('已通过认证');
});

2. 增加空值防御判断 #

在访问req.signedCookies.user前，先检查req.signedCookies是否存在，避免直接访问属性报错：

// 修改auth函数中的判断逻辑
if (!req.signedCookies || !req.signedCookies.user) {
  res.cookie("user", "admin", { signed: true });
}

3. 升级cookie-parser到最新稳定版 #

若为版本兼容问题，执行命令升级：

npm install cookie-parser@latest

4. Postman中正确处理Cookie #

首次请求后，Postman会自动保存服务端返回的Cookie，后续请求会自动携带。若手动测试，可在Postman的Headers面板添加Cookie字段，值为服务端返回的签名Cookie（格式示例：user=s%3Aadmin.xxxxxx）。

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