Mongoose向数组字段push时触发CastError的原因及解决方案

场景与代码重现 #

User模型Schema定义 #

const userSchema = new mongoose.Schema({
    followers: [
        {
            type: mongoose.Schema.Types.ObjectId,
            ref: "User",
        },
    ],
    requests: [
        {
            type: mongoose.Schema.Types.ObjectId,
            ref: "User",
        },
    ]
})

需求与出错的更新代码 #

需求：将当前文档requests字段中的所有ID追加到followers数组，随后清空requests数组。
执行的更新代码：

User.updateOne(
    { _id: req.user._id },
    { $push: { followers: { $each: "$requests" } }, $set: { requests: [] } }
)

错误信息 #

CastError: Cast to ObjectId failed for value "$requests" (type string) at path "followers" because of "BSONError"

错误原因分析 #

MongoDB的普通更新语法（非聚合管道模式）中，$push的$each参数无法直接引用当前文档的字段值（如"$requests"）。这里的"$requests"会被当作字符串字面量处理，而非指向文档的requests字段。由于followers字段要求存储ObjectId类型，mongoose尝试将字符串"$requests"转换为ObjectId时失败，因此抛出CastError。

可行解决方案 #

方案一：使用聚合管道更新（推荐） #

MongoDB 4.2及以上版本支持用聚合管道作为更新操作的第二个参数，允许直接引用文档自身字段。通过$concatArrays合并数组，同时清空requests：

User.updateOne(
    { _id: req.user._id },
    [
        { $set: { followers: { $concatArrays: ["$followers", "$requests"] } } },
        { $set: { requests: [] } }
    ]
)

方案二：分步查询+更新 #

先查询目标文档获取requests数组，再执行更新操作。适合不支持聚合管道的旧版MongoDB，但需注意并发场景下的数据一致性问题：

const user = await User.findById(req.user._id);
if (user) {
    await User.updateOne(
        { _id: req.user._id },
        { $push: { followers: { $each: user.requests } }, $set: { requests: [] } }
    );
}

方案三：使用findByIdAndUpdate结合聚合管道 #

与方案一逻辑一致，通过findByIdAndUpdate简化语法，可选返回更新后的文档：

User.findByIdAndUpdate(
    req.user._id,
    [
        { $set: { followers: { $concatArrays: ["$followers", "$requests"] } } },
        { $set: { requests: [] } }
    ],
    { new: true } // 可选，返回更新后的文档
)

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