Express.js TypeError求助：无法读取undefined的'name'属性

核心原因 #

这个错误的本质是你尝试访问一个undefined值的name属性——也就是说，代码中某个你预期为对象的变量，实际运行时未被正确初始化或赋值，最终变成了undefined。

排查与修复步骤 #

1. 精准定位报错行 #

先看Node.js报错信息里的调用栈，找到触发错误的具体代码行。比如报错信息会显示：

TypeError: Cannot read properties of undefined (reading 'name')
    at /your-project-path/index.js:36:12
    at Layer.handle [as handle_request] (.../node_modules/express/lib/router/layer.js:95:5)

直接定位到index.js的36行，确认该行中读取.name的目标变量是什么。

2. 检查变量的赋值逻辑 #

根据定位到的变量，逐一排查：

• 如果是请求对象的属性（比如req.user.name）：检查是否跳过了依赖的中间件（比如身份验证中间件），导致该属性未被初始化；
• 如果是自定义模块变量：确认导入顺序是否正确，或者该变量是否是异步初始化的（比如在数据库连接完成前就被调用）；
• 如果是外部数据（比如数据库查询结果）：检查查询是否返回了undefined（比如查询不到对应数据时未做处理）。

3. 添加防御性代码 #

在访问.name前，先判断目标对象是否存在，避免直接访问：

// 方式1：使用可选链操作符（ES2020+）
const targetName = yourObject?.name;

// 方式2：显式条件判断
let targetName;
if (yourObject) {
  targetName = yourObject.name;
} else {
  // 处理对象不存在的场景，比如返回默认值或抛出明确错误
  targetName = '默认名称';
  // 或者
  throw new Error('目标对象未初始化');
}

4. 验证新增功能的影响 #

你新增的功能可能引入了以下问题：

• 修改了原有变量的作用域（比如把全局变量改为局部变量，导致其他代码无法访问）；
• 打乱了异步操作的顺序（比如在异步函数完成前就访问其返回值）；
• 调整了中间件的执行顺序（比如依赖的中间件被放到了路由之后）。

示例修复 #

假设报错代码是：

app.get('/user-info', (req, res) => {
  res.json({ name: req.user.name });
});

修复后：

app.get('/user-info', (req, res) => {
  if (!req.user) {
    return res.status(401).json({ error: '用户未登录' });
  }
  res.json({ name: req.user.name });
});

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