Mongoose查询文章列表时如何返回分类名称而非分类ID

你可以根据现有代码的配置情况，选以下两种方案实现：

方案1：使用 Mongoose 原生 populate 方法（推荐） #

这是Mongoose设计用来处理集合关联的标准方法，代码可读性和维护性最好。

• 第一步：先确认Post模型的Schema配置，给category字段加上关联引用：

// post.model.js
const mongoose = require('mongoose')

const postSchema = new mongoose.Schema({
  title: String,
  content: String,
  // 你当前存的category是数字类型ID，type就设为Number；如果存的是MongoDB自动生成的ObjectId，就替换为mongoose.Schema.Types.ObjectId
  category: {
    type: Number,
    ref: 'Category' // 这里的值必须和你注册Category模型时传入的第一个参数完全一致，大小写敏感
  }
})

module.exports = mongoose.model('Post', postSchema)

• 第二步：修改控制器的查询逻辑，关联查询分类后格式化返回结构：

exports.get = async (req, res, next) => {
    try {
        const posts = await Post.find()
          .populate({
            path: 'category',
            select: 'name -_id' // 只查询分类的name字段，排除默认返回的_id
          })
        // 将嵌套的分类对象转为纯名称字符串，匹配目标返回格式
        const formattedPosts = posts.map(post => {
          const postData = post.toObject()
          // 处理分类不存在的边界情况，避免报错
          postData.category = postData.category?.name || null
          return postData
        })
        res.send(formattedPosts)
    } catch (err) { next(err) }
}

方案2：使用 MongoDB 聚合管道 $lookup #

如果你不想修改现有Schema配置，或者希望数据库直接返回目标格式、不需要后续JS处理，可以用原生聚合语法一步完成：

exports.get = async (req, res, next) => {
    try {
        const posts = await Post.aggregate([
          // 关联分类集合
          {
            $lookup: {
              from: 'categories', // 替换为你分类集合的实际名称，Mongoose默认规则是模型名小写加s，Category对应为categories
              localField: 'category', // 文章表存储分类ID的字段
              foreignField: '_id', // 分类表用来匹配ID的字段，如果你用自定义数字ID就换成对应字段名，比如categoryId
              as: 'categoryDetail'
            }
          },
          // 把关联得到的分类数组拆为单条文档，保留没有匹配到分类的文章
          { $unwind: { path: '$categoryDetail', preserveNullAndEmptyArrays: true } },
          // 重构返回字段，直接输出目标结构
          {
            $project: {
              title: 1,
              content: 1,
              category: '$categoryDetail.name'
            }
          }
        ])
        res.send(posts)
    } catch (err) { next(err) }
}

踩坑提示 #

• 用populate时如果ref名称写错、和模型注册名不匹配，会返回null或者关联失败，注意核对大小写。
• 用$lookup时如果集合名填错，会查不到关联的分类数据，不确定集合名可以直接连接MongoDB查看实际名称。
• 一定要处理分类被删除的场景，避免某篇文章关联的分类ID不存在时接口抛出异常。

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