MongoDB聚合查询$lookup无法获取关联集合数据问题排查

核心问题1：$lookup返回数组，直接取.name得到的是数组而非单个值 #

MongoDB的$lookup聚合阶段，无论匹配到多少条文档，都会将结果封装成数组返回（哪怕只有1条匹配）。你的样例中category字段是一个包含单个分类对象的数组，此时$category.name会生成一个类似["Category-873441698"]的数组，而不是直接返回字符串。如果展示逻辑无法解析数组，就会显示为空。

核心问题2：可能存在字段类型不匹配 #

虽然你提供的样例里两个集合的关联字段都是字符串，但实际数据库中很可能存在类型不一致：

• categories集合的_id默认是ObjectId类型（MongoDB主键默认类型）
• project集合的categoryId是字符串类型

这种情况下，字符串和ObjectId无法匹配，导致$lookup返回空数组，$category.name自然为空。

解决办法 #

针对问题1：提取数组中的单个值

修改聚合查询的$project阶段，用$first或$arrayElemAt从数组中取出分类名称：

db.getCollection("project").aggregate([
    {
        $lookup: {
            from: "categories",
            localField: "categoryId",
            foreignField: "_id",
            as: "category"
        }
    },
    {
        $project: {
            id: 1,
            name: 1,
            categoryId: 1,
            inclusionDate: 1,
            updateDate: 1,
            categoryName: { $ifNull: [ { $first: "$category.name" }, "deleted" ] }
        }
    }
])

针对问题2：统一字段类型

如果是类型不匹配导致的无法关联，有两种处理方式：

1. 临时转换类型进行匹配（无需修改原数据）
   修改$lookup阶段，将project的categoryId转换为ObjectId后再匹配：

db.getCollection("project").aggregate([
    {
        $lookup: {
            from: "categories",
            let: { projectCategoryId: { $toObjectId: "$categoryId" } },
            pipeline: [
                { $match: { $expr: { $eq: ["$_id", "$$projectCategoryId"] } } }
            ],
            as: "category"
        }
    },
    {
        $project: {
            id: 1,
            name: 1,
            categoryId: 1,
            inclusionDate: 1,
            updateDate: 1,
            categoryName: { $ifNull: [ { $first: "$category.name" }, "deleted" ] }
        }
    }
])

2. 批量修改原数据类型（永久解决）
   将project集合中所有字符串类型的categoryId转换为ObjectId：

db.project.updateMany(
    { categoryId: { $type: "string" } },
    [ { $set: { categoryId: { $toObjectId: "$categoryId" } } } ]
)

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