Mongoose无法填充另一集合关联文档问题求助

我在学习Node.js与MongoDB/Mongoose开发孩子奖励追踪项目时，遇到了关联文档填充的问题：创建Child后关联生成RewardDeposit，但Child的deposits数组始终为空，调用populate方法也无效。想请教三个问题：

1. 是否必须使用子文档？
2. 顶层关联文档能否填充？
3. 我的Schema设计是否有误？

Child Schema #

models.mongoose.Child = mongoose.model('Child', new mongoose.Schema({
  firstname: {
    type: String,
    required: true,
  },
  lastname: {
    type: String,
    required: true,
  },
  nickname: String,
  datecreated: {
    type: Date,
    default: () => Date.now(),
    immutable: true,
  },
  datemodified: Date,
  deposits: [
    {
      type: mongoose.Schema.Types.ObjectId,
      ref: 'RewardDeposit'
    }
  ]
}));

RewardDeposit Schema #

models.mongoose.RewardDeposit = mongoose.model('RewardDeposit', new mongoose.Schema({
  for: String,
  qty: Number,
  datecreated: {
    type: Date,
    default: () => Date.now(),
    immutable: true,
  },
  datemodified: Date,
  child: {type: mongoose.Types.ObjectId, ref: "Child"}
}));

测试代码 #

var cid = "";

const c = new models.mongoose.Child;
c.firstname = "XXXXX";
c.lastname = "XXXXXX";
c.nickname = "XXXXXXX";
c.save()
.then((c) => {
  cid = c._id;
  const d = new models.mongoose.RewardDeposit;
  d.for = "YYYY";
  d.qty = 10;
  d.child = c;
  d.save()
})

查询代码 #

models.mongoose.Child.findById(cid).populate('deposits');

Child文档示例 #

{
    "_id": "6707fd5f98df9d7355b35580",
    "deposits": [],
    "datecreated": "2024-10-10T16:14:23.719Z",
    "firstname": "XXXXX",
    "lastname": "XXXXXX",
    "nickname": "XXXXXXX",
    "__v": 0
}

RewardDeposit文档示例 #

{
    "_id": "6707fd6098df9d7355b35583",
    "datecreated": "2024-10-10T16:14:24.630Z",
    "for": "YYYY",
    "qty": 10,
    "child": "6707fd5f98df9d7355b35580",
    "__v": 0
}

核心问题：双向关联未完整维护 #

你的Schema设计本身没问题，顶层关联文档完全可以填充，不需要必须用子文档。问题出在测试代码只维护了RewardDeposit到Child的关联，没把RewardDeposit的ID添加到Child的deposits数组中——Mongoose不会自动维护双向关联，必须手动处理两边的关系。

修复后的测试代码 #

let cid = "";

const c = new models.mongoose.Child({
  firstname: "XXXXX",
  lastname: "XXXXXX",
  nickname: "XXXXXXX"
});

c.save()
.then(async (savedChild) => {
  cid = savedChild._id;
  const d = new models.mongoose.RewardDeposit({
    for: "YYYY",
    qty: 10,
    child: savedChild._id
  });
  const savedDeposit = await d.save();
  // 关键步骤：把新创建的存款ID加入Child的deposits数组并保存
  savedChild.deposits.push(savedDeposit._id);
  await savedChild.save();
})
.catch(err => console.error(err));

其他注意事项 #

1. 查询需执行Promise：你原查询代码只是构建了查询对象，没有实际获取结果，要加上.then()或用await：

// 用then方式
models.mongoose.Child.findById(cid)
  .populate('deposits')
  .then(child => console.log(child))
  .catch(err => console.error(err));

// 或用async/await
async function getChildWithDeposits() {
  const child = await models.mongoose.Child.findById(cid).populate('deposits');
  console.log(child);
}
getChildWithDeposits();

2. Schema优化建议：
   • for是MongoDB保留关键字，建议重命名为reason或description，避免潜在问题
   • 给datemodified添加自动更新钩子：

   datemodified: {
     type: Date,
     default: Date.now
   }
   // 预保存钩子，更新时自动修改时间
   schema.pre('save', function(next) {
     this.datemodified = Date.now();
     next();
   });
   

你的三个疑问解答 #

1. 是否必须使用子文档？：不需要。双向引用的顶层文档是可行设计，适合需要单独查询RewardDeposit的场景（比如统计所有奖励记录）。
2. 顶层关联文档能否填充？：可以。只要正确维护两边的关联关系，populate方法就能正常工作。
3. Schema设计是否有误？：基本没问题，仅for字段建议改名，另外可优化datemodified的自动更新逻辑。

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