Mongoose常规填充正常，虚拟填充失效原因排查

针对你遇到的Mongoose 6虚拟填充未携带查询条件的问题，以下是几个最可能的原因及对应解决方案：

1. Schema定义顺序错误 #

如果你的代码是先创建ToolRecord模型，再定义虚拟填充字段，那么虚拟填充的配置不会被应用到模型上，导致Mongoose无法正确识别关联规则，最终生成无过滤条件的查询。

错误示例：

const toolRecordSchema = new mongoose.Schema({
  userId: { type: mongoose.Schema.Types.ObjectId },
});
// 先创建模型，再定义虚拟字段，配置无效
const ToolRecord = mongoose.model('ToolRecord', toolRecordSchema);
toolRecordSchema.virtual("user", {
  ref: "User",
  localField: "userId",
  foreignField: "_id",
  justOne: true,
})

正确写法：

const toolRecordSchema = new mongoose.Schema({
  userId: { type: mongoose.Schema.Types.ObjectId },
});
// 先定义虚拟填充，再创建模型
toolRecordSchema.virtual("user", {
  ref: "User",
  localField: "userId",
  foreignField: "_id",
  justOne: true,
})
const ToolRecord = mongoose.model('ToolRecord', toolRecordSchema);

2. 主查询未返回userId字段 #

Mongoose需要从ToolRecord的查询结果中提取userId的值，才能构建关联User的查询条件。如果查询时通过select排除了userId，或者schema中userId设置了select: false，就会导致Mongoose无法获取关联所需的字段值，进而执行无过滤的users.find({})。

检查方法：
执行db.ToolRecord.find().select('userId')，确认返回的文档中存在有效的userId值。

解决方法：

• 移除查询中的select('-userId')这类排除字段的语句；
• 如果schema中显式设置了userId: { type: mongoose.Schema.Types.ObjectId, select: false }，改为select: true（默认即为true，无需额外设置，除非之前手动修改过）。

3. 字段类型不匹配 #

如果ToolRecord文档中的userId存储的是字符串类型，而非ObjectId，而User模型的_id是ObjectId类型，Mongoose无法匹配关联关系，会导致生成无过滤条件的查询。

验证方法：
在MongoDB shell中执行db.ToolRecord.findOne({userId: {$type: "string"}})，如果返回结果，说明存在类型不匹配的文档。

解决方法：
批量将userId字段转换为ObjectId类型，例如：

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

4. Mongoose版本bug #

Mongoose 6的某些早期版本存在虚拟填充的已知问题，建议升级到6.x系列的最新稳定版本，修复可能存在的bug。

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