如何让Mongoose的List模型items字段支持接收多个item条目

你的模型定义本身支持items字段存储多个条目（子文档数组），无法存入多个通常是操作方法错误或字段约束冲突导致，按以下场景排查修改：

场景1：新建List文档时直接存入多个item #

创建时直接给items字段传入符合itemSchema格式的对象数组即可，示例代码：

const newList = new ListData({
  name: "购物清单1",
  created: new Date(),
  // 直接传多个item的数组
  items: [
    {
      name: "苹果",
      created: new Date(Date.now() - 1000 * 60),
      quantity: 2,
      category: []
    },
    {
      name: "牛奶",
      created: new Date(Date.now() - 1000 * 120),
      quantity: 1,
      category: []
    }
  ],
  shop: []
})
await newList.save()

场景2：给已存在的List文档追加多个item #

方法1：原子更新操作（推荐，避免并发冲突） #

使用$push搭配$each操作符批量追加，不会覆盖原有数组内容：

await ListData.updateOne(
  { _id: "你的list文档id" }, // 查询条件，定位到要更新的list
  {
    $push: {
      items: {
        $each: [ // 这里放要追加的多个item对象
          {
            name: "面包",
            created: new Date(Date.now() - 1000 * 180),
            quantity: 3,
            category: []
          },
          {
            name: "鸡蛋",
            created: new Date(Date.now() - 1000 * 240),
            quantity: 10,
            category: []
          }
        ]
      }
    },
    updated: new Date()
  }
)

方法2：先查文档修改后保存 #

const targetList = await ListData.findById("你的list文档id")
// 调用数组push方法批量添加
targetList.items.push(
  {
    name: "面包",
    created: new Date(Date.now() - 1000 * 180),
    quantity: 3,
    category: []
  },
  {
    name: "鸡蛋",
    created: new Date(Date.now() - 1000 * 240),
    quantity: 10,
    category: []
  }
)
targetList.updated = new Date()
await targetList.save()

常见踩坑说明 #

• 不要使用$set: {items: 单个item对象}的写法，会直接覆盖整个items数组，仅保留单个元素。
• 你当前的itemSchema中created字段设置了unique: true，该约束是全局唯一，即整个listData集合里所有item子文档的created值都不能重复，如果批量存入的多个item存在created值相同的情况，会触发唯一键冲突报错，导致存入失败。如果不需要子文档created全局唯一，建议删除该约束：

// 修改itemSchema的created字段配置，去掉unique: true
created: { type: Date, required: true },

内容的提问来源于stack exchange，提问作者Miloš Milutinov