MongoDB Node.js驱动Aggregate结果与Robo3T不一致问题排查

可能的原因及修复步骤 #

1. 确保ObjectId正确解析 #

Node.js中必须从MongoDB驱动显式导入并使用ObjectId，否则传入的字符串无法被正确识别为MongoDB的ObjectId类型，会导致$match阶段匹配异常，进而影响后续关联查询的结果数量。

修正后的Node.js查询代码示例：

const { MongoClient, ObjectId } = require('mongodb');

async function executeAggregate() {
  const client = new MongoClient('你的MongoDB连接URI');
  await client.connect();
  const db = client.db('目标数据库名称');
  
  const queryResult = await db.collection('roles').aggregate([
    { $match: { "_id": ObjectId("63c8ad93eb3b2d975834a6d0") } },
    {
      $lookup: {
        from: 'modules',
        localField: 'moduleAccess.moduleId',
        foreignField: '_id',
        as: 'moduleData'
      }
    },
    { $unwind: '$moduleData' }
  ]).toArray();
  
  console.log(queryResult);
  await client.close();
}

executeAggregate().catch(console.error);

2. 对齐驱动的BSON解析配置 #

MongoDB Node.js驱动4.x版本的默认BSON解析选项可能和Robo3T存在差异，可在创建客户端时显式指定解析规则，确保数据处理逻辑一致：

const client = new MongoClient('你的MongoDB连接URI', {
  bsonOptions: {
    promoteLongs: true,
    promoteValues: true,
    promoteBuffers: false
  }
});

3. 验证原始数据结构 #

确认roles集合中目标文档的moduleAccess是数组类型，且每个元素的moduleId均为有效的ObjectId。可在Robo3T中执行以下语句验证：

db.getCollection('roles').find({"_id": ObjectId("63c8ad93eb3b2d975834a6d0")}, {moduleAccess: 1})

如果moduleAccess不是数组，$lookup只会返回单个结果，$unwind后自然只有一条数据。

4. 确认连接环境一致性 #

检查Node.js客户端连接的MongoDB实例是否和Robo3T完全一致（同一数据库、同一集群），避免因连接不同环境导致的数据差异。

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