基于Parse Server的Mongoose虚拟字段填充异常问题求助

问题背景 #

Parse Server生成的关联字段格式为「外部集合名+$+外部ID」（如Stores$x1y2z3），无法直接通过Mongoose Schema的ref属性使用原生.populate()，使用异步虚拟字段getter会返回Pending状态的Promise，无法正常填充关联文档。

解决方案 #

利用Mongoose的**虚拟填充（Virtual Populate）**功能，通过同步虚拟字段拆分关联ID，再配置虚拟关联实现原生populate效果：

1. 定义同步虚拟字段提取关联ID #

在User Schema中添加同步虚拟字段，从_p_store中拆分出Store的ID：

const userSchema = new mongoose.Schema({
  // 原有字段定义...
  _p_store: String
});

// 同步提取Store ID的虚拟字段
userSchema.virtual('storeId').get(function() {
  if (!this._p_store) return null;
  return this._p_store.split('$')[1];
});

2. 配置虚拟填充关联 #

基于上面的storeId虚拟字段，配置store虚拟关联，关联到Store模型：

userSchema.virtual('store', {
  ref: 'Store', // 关联的目标模型
  localField: 'storeId', // 本地用于关联的字段（即上面的虚拟字段）
  foreignField: '_id', // 目标模型中匹配的字段
  justOne: true // 只返回单个关联文档
});

3. 执行查询并填充关联 #

查询时需要指定{ virtuals: true }以包含虚拟字段，再调用.populate()：

const User = mongoose.model('User', userSchema);
const Store = mongoose.model('Store', storeSchema);

// 查询用户并填充关联的Store
const user = await User.findOne({ _id: 'a1b2c3' })
  .populate('store')
  .setOptions({ virtuals: true });

console.log(user.store); // 已填充的Store文档，而非Pending Promise

双向关联配置（可选） #

如果需要从Store反向关联User，对Store Schema做同样处理：

const storeSchema = new mongoose.Schema({
  // 原有字段定义...
  _p_user: String
});

storeSchema.virtual('userId').get(function() {
  if (!this._p_user) return null;
  return this._p_user.split('$')[1];
});

storeSchema.virtual('user', {
  ref: 'User',
  localField: 'userId',
  foreignField: '_id',
  justOne: true
});

// 查询Store并填充User
const store = await Store.findOne({ _id: 'x1y2z3' })
  .populate('user')
  .setOptions({ virtuals: true });

关键说明 #

• 避免使用异步虚拟字段getter：Mongoose在处理虚拟填充时不会等待异步getter的结果，因此会返回Pending Promise。
• 必须启用虚拟字段：查询时通过setOptions({ virtuals: true })或在Schema中配置toJSON: { virtuals: true }、toObject: { virtuals: true }，确保虚拟字段被包含在返回结果中。
• 兼容Parse Server的ID格式：由于文档ID是普通字符串而非ObjectId，无需额外类型转换，直接匹配即可。

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