Express+Passport认证场景下Handlebars无法访问对象属性问题

你遇到的后端访问属性报错、模板中点语法无法读取用户字段的问题，核心原因是req.user是Mongoose查询返回的文档实例对象，不是原生普通JavaScript对象。

你观察到的几个看似矛盾的现象本质都是Mongoose文档实例的内置机制导致的：

• 直接console.log(req.user)、JSON.stringify(req.user)能正常输出完整用户内容，是因为Mongoose文档实例自定义了toString、toJSON方法，打印、序列化时会自动转换为普通对象格式输出，视觉上和普通对象没有区别
• 直接在代码中访问req.user.username报错，除了未登录场景下req.user本身为undefined的情况外，Mongoose文档实例的字段是通过内部getter代理、原型链方法实现访问的，不是直接挂在对象自身的可枚举属性上
• Handlebars模板中直接写{{user}}能输出完整内容，是因为模板渲染时会调用对象的toString方法，刚好触发Mongoose实例的自定义转换逻辑输出完整字符串；但用{{user.username}}点语法访问时，模板引擎只会查找对象自身的可枚举属性，无法识别Mongoose代理的字段，因此读不到值。

两种方案选其一即可，推荐第一种从根源解决问题：

• 反序列化查询用户时直接返回普通JS对象
  修改Passport的deserializeUser逻辑，在Mongoose查询时加.lean()，让查询结果直接返回原生普通对象，不再是Mongoose文档实例：

passport.deserializeUser(function(_id, done) {
  console.log(`deserialize search for: ${_id}`);
  User.findById(_id).lean().exec(function(err, user) {
    console.log(`deserialization find user: ${user}`);
    done(err, user);
  });
});

• 渲染模板前手动转换对象
  如果不想修改反序列化逻辑，可以在路由里把req.user转成普通对象后再传给模板，同时补全未登录场景的空值判断，避免直接访问undefined的属性报错：

app.get('/', (req, res) => {
  // 未登录时user为null，避免属性访问报错
  const renderUser = req.user ? req.user.toObject() : null;
  res.render('index', {
    layout: false,
    user: renderUser,
  });
});

修改完成后，无论是后端代码直接访问user.username，还是模板中用{{user.username}}点语法读取字段，都可以正常获取到对应的值。

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