为何Mongoose的.populate方法返回[model]而非集合内容？

问题场景 #

创建关联Author的Course模型后，使用populate('author')查询课程，日志仅显示author: [model]，无法获取作者的实际字段内容。

模型定义代码 #

const Course = mongoose.model(
  "Course",
  new mongoose.Schema({
    name: String,
    author: {
      type: mongoose.Schema.Types.ObjectId,
      ref: "Author",
    },
  })
);

const Author = mongoose.model(
  "Author",
  new mongoose.Schema({
    name: String,
    bio: String,
    website: String,
  })
);

查询代码 #

async function listCourses() {
  const courses = await Course.find()
    .populate('author')
    .select("name author");
  console.log(courses);
}

日志输出 #

_doc: {
      _id: 632c00981186461909cebb20,
      name: 'Node Course',
      author: [model]
    },

解决方法 #

1. 调整模型定义顺序 #

Mongoose要求被引用的模型必须先定义，否则ref无法正确识别关联。当前代码先定义Course后定义Author，导致ref: "Author"无法关联到正确模型，调整顺序即可：

// 先定义Author模型
const Author = mongoose.model(
  "Author",
  new mongoose.Schema({
    name: String,
    bio: String,
    website: String,
  })
);

// 再定义Course模型
const Course = mongoose.model(
  "Course",
  new mongoose.Schema({
    name: String,
    author: {
      type: mongoose.Schema.Types.ObjectId,
      ref: "Author",
    },
  })
);

2. 验证关联的Author文档是否存在 #

检查Course文档中author字段存储的ObjectId，是否在Author集合中有对应文档。若ID不存在，populate会返回null或显示[model]（取决于Mongoose版本），可通过以下代码验证：

// 取第一个课程的author ID进行查询
const targetCourse = await Course.findOne();
const authorExists = await Author.findById(targetCourse.author);
console.log(authorExists); // 输出null则说明该ID对应的作者不存在

3. 调整日志输出方式查看真实内容 #

Mongoose文档对象直接console.log时，会因内部结构简化显示[model]，可转换为纯JSON对象或使用lean()获取普通JS对象：

async function listCourses() {
  // 方式1：转换为JSON输出
  const courses = await Course.find()
    .populate('author')
    .select("name author");
  console.log(JSON.stringify(courses, null, 2));

  // 方式2：使用lean()直接返回普通JS对象
  const leanCourses = await Course.find()
    .populate('author')
    .select("name author")
    .lean();
  console.log(leanCourses);
}

4. 显式指定populate的model参数（可选） #

若调整顺序后仍有问题，可在populate时显式指定模型，避免Mongoose无法解析ref：

async function listCourses() {
  const courses = await Course.find()
    .populate({ path: 'author', model: Author })
    .select("name author");
  console.log(JSON.stringify(courses, null, 2));
}

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