Mongoose查询结果传至Pug视图仅能获取_id，其他属性返回undefined

看起来你遇到了Mongoose查询结果在Pug视图里属性访问异常的问题——只能拿到_id，其他属性比如word.name返回undefined。我来帮你一步步排查和解决：

最常见的原因：Mongoose文档未转为普通JS对象 #

Mongoose默认返回的是Document实例，它自带了很多Mongoose的内部方法和属性，虽然大部分场景下Pug能正常访问属性，但偶尔会出现属性无法读取的情况。解决这个问题最简单的方式是用lean()方法让查询直接返回普通JavaScript对象：

// 在你的查询中添加lean()
router.get("/", authCheck, async (req, res) => {
  try {
    // 假设你是查询Dictionary集合，关联Words的话记得populate
    const dictionaries = await Dictionary.find()
      .populate('words') // 如果Dictionary关联了Words模型，必须populate才能拿到关联数据
      .lean(); // 关键：转为普通JS对象
    res.render("你的视图名", { dictionaries });
  } catch (err) {
    errorlog(err);
    res.status(500).send("服务器错误");
  }
});

如果已经拿到了Document实例，也可以手动转为普通对象：

const plainDictionaries = dictionaries.map(doc => doc.toObject());
res.render("你的视图名", { dictionaries: plainDictionaries });

其他可能的原因及排查步骤 #

1. 查询时错误限制了返回字段 #

如果你在查询时用了select或者投影参数，不小心只保留了_id，那自然拿不到其他属性。比如这种错误写法：

// 错误：只返回_id字段
const dictionaries = await Dictionary.find({}, { _id: 1 });

要确保投影包含你需要的字段，比如要拿到words.name，如果是关联查询，记得用populate并指定返回字段：

const dictionaries = await Dictionary.find()
  .populate({
    path: 'words',
    select: 'name' // 明确指定要返回name字段
  })
  .lean();

2. 模型或数据库数据不匹配 #

检查你的Words模型定义，确认确实有name字段：

// models/words.js
const mongoose = require('mongoose');
const wordSchema = new mongoose.Schema({
  name: { type: String, required: true },
  // 其他字段...
});
module.exports = mongoose.model('Words', wordSchema);

同时登录MongoDB数据库，查看words集合里的文档，确认name字段有实际值，没有值的话访问自然是undefined。

3. Pug视图中的访问路径错误 #

如果你的Dictionary文档里的words是数组，在Pug里需要遍历才能访问每个word的属性，比如：

// 正确的遍历写法
each dict in dictionaries
  h3= dict.name
  each word in dict.words
    p= word.name

如果直接写dict.word.name（少了复数s或者路径错误），也会返回undefined。

调试小技巧 #

在路由里打印查询结果的结构，确认数据是否正确：

router.get("/", authCheck, async (req, res) => {
  try {
    const dictionaries = await Dictionary.find().populate('words').lean();
    // 打印完整数据结构，看看是否包含word.name
    console.log(JSON.stringify(dictionaries, null, 2));
    res.render("你的视图名", { dictionaries });
  } catch (err) {
    errorlog(err);
    res.status(500).send("服务器错误");
  }
});

这样就能快速定位是查询的问题，还是视图渲染的问题。

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