Mongoose 数组字段存储对象引用与自定义属性实现问题

此前的实现没有把「单个成就项的关联ID+自定义状态」聚合为同一个业务实体，要么把数组拆成零散的单属性对象依次push，要么把关联ID和状态拆成两个独立数组。这种写法既破坏了数据的一致性，也不匹配Mongoose的Schema校验规则——不符合Schema定义结构的字段会被默认过滤，这也是自定义属性无法正常写入的核心原因。

直接将achievements字段定义为内嵌子文档数组，每个数组元素是同时包含关联引用、自定义状态的聚合对象，参考实现代码：

const accountSchema = new mongoose.Schema({
  // 账户原有其他字段
  achievements: [
    {
      // 关联成就主模型的ObjectId
      achievement: {
        type: Schema.Types.ObjectId,
        ref: 'Achievement',
        required: true
      },
      // 自定义状态字段，直接在子文档上定义默认值
      claimed: {
        type: Boolean,
        default: false
      },
      isDone: {
        type: Boolean,
        default: false
      },
      current: {
        type: Number,
        default: 0
      }
    }
  ]
})

• 新增成就项：直接往achievements数组push完整的子文档对象即可，Mongoose会自动给未显式传值的字段填充默认值，不需要手动单独push每个属性：

await Account.updateOne(
  { _id: targetAccountId },
  {
    $push: {
      achievements: {
        achievement: newAchievementObjectId
        // 此处无需手动传claimed/isDone/current，自动取默认值
      }
    }
  }
)

• 更新单个成就的状态：通过位置操作符匹配对应成就后直接改子文档字段即可：

// 标记指定成就为已完成、已领取、进度拉满
await Account.updateOne(
  {
    _id: targetAccountId,
    'achievements.achievement': targetAchievementObjectId
  },
  {
    $set: {
      'achievements.$.isDone': true,
      'achievements.$.claimed': true,
      'achievements.$.current': 100
    }
  }
)

• 查询关联数据：直接通过populate即可在读取状态的同时带出成就主模型的详情，无需手动匹配数组索引：

const accountDetail = await Account.findById(targetAccountId)
  .populate('achievements.achievement')

将「成就关联ID」和「对应状态」拆为两个独立数组的方案不推荐使用，存在几个明显的问题：

• 数据一致性无保障：两个数组的增删改没有天然的事务绑定，很容易出现索引错位、长度不匹配的问题，后续排查这类数据bug的成本极高
• 查询效率低：需要手动根据数组索引匹配ID和对应状态，没法直接用Mongoose的populate能力联表取数，代码冗余度高
• 维护性差：所有涉及成就的操作都要同步操作两个数组，漏改任意一个数组都会直接产生脏数据

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