MongoDB使用$regex时Populate子文档失效问题

用Mongoose查询MongoDB数据时，直接精确匹配用户名能正常返回用户，并且profiles子文档也能被正确填充；但改用$regex做模糊匹配时，返回的用户对象里profiles始终是空的。

使用正则的查询代码：

let u = new RegExp(`${req.params.username}`, 'i');

let user = await User.findOne({
  userName: { $regex: u },
}).populate({
  path: 'profiles',
  populate: {
    path: 'companyId',
    match: { _id: { $exists: true } },
  },
});

不使用正则的正常查询代码：

let user = await User.findOne({
  userName: req.params.username,
}).populate({
  path: 'profiles',
  populate: {
    path: 'companyId',
    match: { _id: { $exists: true } },
  },
});

1. 先确认正则匹配到的用户本身有没有profiles数据 #

先去掉populate逻辑，直接打印正则查询返回的用户原始数据，检查profiles字段是否本来就为空：

let u = new RegExp(`${req.params.username}`, 'i');
let user = await User.findOne({ userName: { $regex: u } });
console.log(user.profiles); // 查看该字段是否有有效值

如果这里profiles就是空的，说明正则匹配到的用户确实没有关联任何profiles数据，和populate逻辑无关。

2. 简化populate的match条件 #

原代码中match: { _id: { $exists: true } }属于多余条件——companyId作为关联字段，本身应为有效的ObjectId，不存在时populate会自动返回null，没必要额外过滤。简化后重新测试：

let u = new RegExp(`${req.params.username}`, 'i');

let user = await User.findOne({
  userName: { $regex: u },
}).populate({
  path: 'profiles',
  populate: { path: 'companyId' }
});

3. 检查并升级Mongoose版本 #

部分旧版Mongoose在正则查询+深层populate的场景下可能存在兼容bug，尝试升级到最新稳定版：

npm install mongoose@latest

4. 手动执行populate（备选方案） #

如果以上方法都无效，可以先用lean()获取原始文档，再手动调用populate方法：

let u = new RegExp(`${req.params.username}`, 'i');
let user = await User.findOne({ userName: { $regex: u } }).lean();

if (user) {
  // 手动填充profiles及其关联的companyId
  user.profiles = await Profile.populate(user.profiles, { path: 'companyId' });
}

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