如何在MongoDB的对象数组中更新指定元素 不存在时自动新增字段

现有代码核心问题 #

• 你当前的$set写法直接把socials字段覆盖为单个对象，完全没有按「对象数组」的逻辑做更新，是最核心的错误
• findOneAndUpdate执行后已经直接写入数据库，后续调用user.save()完全冗余，反而可能因返回的是旧文档导致数据覆盖
• 没有加入数组匹配、 upsert 逻辑，无法实现「存在则更新、不存在则新增」的效果

修复后代码（常规兼容版本，所有MongoDB版本可用） #

if (req.method === 'PATCH') {
    const { title, description, socials } = req.body;
    const { name, link } = socials;

    try {
        // 先尝试更新数组中已存在的对应name元素
        const updateRes = await User.updateOne(
            {
                email: process.env.EMAIL_USERNAME,
                "socials.name": name // 匹配数组中name相同的元素
            },
            {
                $set: {
                    title,
                    description,
                    "socials.$.link": link // 更新匹配到的数组元素的link
                }
            }
        );

        // 未匹配到元素说明该name不存在，执行新增
        if (updateRes.matchedCount === 0) {
            await User.updateOne(
                { email: process.env.EMAIL_USERNAME },
                {
                    $set: { title, description },
                    $push: { socials: { name, link } } // 往数组追加新元素
                }
            );
        }

        res.status(200).json({
            status: 'success',
            title,
            description,
            socials,
        });
    } catch (err) {
        // 可根据业务需求自定义错误处理逻辑
        res.status(500).json({ status: 'error', msg: err.message })
    }
}

补充说明 #

• 如果你判断数组元素是否存在的依据不是name字段，把匹配字段换成对应业务字段即可
• 如果你需要拿到更新后的用户文档返回，可以把updateOne换成findOneAndUpdate，并且加上{ new: true }参数获取更新后的数据
• 若使用MongoDB 4.2及以上版本，可使用聚合管道实现单语句更新，无需两次查询操作：

// 单语句实现版本（仅支持MongoDB 4.2+）
await User.findOneAndUpdate(
    { email: process.env.EMAIL_USERNAME },
    [
        {
            $set: {
                title,
                description,
                socials: {
                    $cond: {
                        if: { $in: [name, "$socials.name"] },
                        then: {
                            $map: {
                                input: "$socials",
                                in: {
                                    $cond: {
                                        if: { $eq: ["$$this.name", name] },
                                        then: { $mergeObjects: ["$$this", { link }] },
                                        else: "$$this"
                                    }
                                }
                            }
                        },
                        else: { $concatArrays: ["$socials", [{ name, link }]] }
                    }
                }
            }
        }
    ],
    { new: true }
)

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