更新MongoDB用户购物车字段时出现JSON循环结构错误

错误原因 #

你遇到的循环引用问题，是因为Mongoose的文档（包括子文档）内部带有__parent、__parentArray这类指向父对象的引用属性。当你直接操作user.cart（比如用slice()复制数组、直接push子文档）时，这些内部引用会形成循环结构，在序列化（比如res.json）或保存文档时触发JSON.stringify的循环引用错误。

解决方案 #

下面提供两种可行的修复方式，推荐第二种更符合Mongoose最佳实践的写法：

方式1：将购物车转为纯JS对象后修改

把Mongoose的文档数组转为普通JavaScript对象数组，去除内部引用后再操作：

// Add product to user's cart
const product = await Product.findOne({_id: req.body.product_id})
if (!product) {
    return res.status(http.statusNotFound).json({
        errors: [{ msg: "Invalid product id" }]
    })
}

// 转为纯JS对象数组，清除Mongoose内部引用
const cart = user.cart.toObject() || [];
cart.push({ product_id: product._id, quantity: req.body.quantity });

user.cart = cart;
await user.save();
res.json({ msg: "Product added to cart" });

方式2：直接向购物车数组push纯JS对象（推荐）

Mongoose支持直接向子文档数组添加普通JS对象，它会自动处理转换，不会引入循环引用：

// Add product to user's cart
const product = await Product.findOne({_id: req.body.product_id})
if (!product) {
    return res.status(http.statusNotFound).json({
        errors: [{ msg: "Invalid product id" }]
    })
}

// 直接push纯JS对象，Mongoose会自动转为子文档
user.cart.push({ product_id: product._id, quantity: req.body.quantity });
await user.save();
res.json({ msg: "Product added to cart" });

额外优化：避免重复添加商品 #

可以先检查购物车中是否已有该商品，存在则更新数量，不存在再添加：

// Add product to user's cart
const product = await Product.findOne({_id: req.body.product_id})
if (!product) {
    return res.status(http.statusNotFound).json({
        errors: [{ msg: "Invalid product id" }]
    })
}

// 查找购物车中是否已有该商品
const existingItem = user.cart.find(item => item.product_id.toString() === product._id.toString());
if (existingItem) {
    existingItem.quantity += req.body.quantity;
    await user.save();
    return res.json({ msg: "Cart quantity updated" });
}

user.cart.push({ product_id: product._id, quantity: req.body.quantity });
await user.save();
res.json({ msg: "Product added to cart" });

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