Cart模型必须嵌套在用户文档内，因独立集合无法保证并发更新的原子性；cartList应定义为包含productId（带ref）、productNum（Number型）和checked的数组，并为cartList.productId建复合索引；添加商品用findOneAndUpdate配合$inc和$pull等原子操作，避免先查后改。
Cart 模型设计必须嵌套在用户文档内，而不是独立集合 —— 否则并发更新、事务一致性、查询效率都会出问题。
为什么不能用独立 cart 集合？
多个请求同时修改同一用户的购物车时，updateOne 无法保证原子性叠加（比如两个请求都读到 productNum: 2，各自 +1 后写回，结果是 3 而不是 4）。MongoDB 的 $inc 和 $push 在数组字段上天然支持原子操作，但前提是这些字段属于同一个文档。
userSchema 中的 cartList 字段怎么定义才安全？
推荐结构如下（注意类型和索引）：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
cartList: [{
productId: { type: mongoose.Schema.Types.ObjectId, ref: 'Product', required: true },
productNum: { type: Number, min: 1, default: 1 },
checked: { type: Boolean, default: true }
}]
-
productId必须带ref，否则 populate 会失效； -
productNum用Number类型，别用String—— 否则$inc失效且排序错乱； - 给
cartList.productId加复合索引：db.users.createIndex({ "cartList.productId": 1, "cartList.userId": 1 })，避免全表扫描； - 不要把商品完整数据存进
cartList，只存 ID + 必要字段（如价格快照），否则库存变更后历史订单价格不一致。
添加商品时怎么避免重复插入？
用 findOneAndUpdate 一条语句搞定查找 + 更新/插入，比先 find 再分路径更可靠：
const result = await User.findOneAndUpdate(
{ _id: userId, 'cartList.productId': productId },
{ $inc: { 'cartList.$.productNum': 1 } },
{ new: true }
);
if (!result) {
await User.findByIdAndUpdate(userId, {
$push: { cartList: { productId, productNum: 1 } }
});
}
-
'cartList.productId': productId是关键条件，利用 MongoDB 数组字段的隐式匹配； -
$inc中的$指向匹配到的数组元素，不是整个数组； -
{ new: true }必须加，否则返回旧文档，result可能为null却没触发if分支。
删除或清空购物车为什么不能只用 remove？
remove 是删整个文档，而你要的是清空 cartList 数组。正确做法是：
- 删某一项：
$pull: { cartList: { productId: xxx } }； - 清空全部：
$set: { cartList: [] }； - 千万别用
save()手动赋值再保存 —— 会覆盖其他并发写入的字段（比如addressList）。
cartList 的更新必须走 findOneAndUpdate 或 findByIdAndUpdate，任何先 find 再 save 的写法，在高并发下必然丢数据。 
