为何ObjectId类型字段未触发自定义必填验证错误信息？

问题描述 #

我在Mongoose中定义了如下字段规则：

category: {
    type: ObjectId,
    ref: "Category",
    required: [true, "Recipe must belong to a category"],
},

但当未选择category时，收到的错误信息却是：

Recipe validation failed: category: Cast to ObjectId failed for value "" (type string) at path "category" because of "BSONError"

请问为何无法触发我设置的自定义必填验证错误信息？

原因及解决办法 #

核心原因 #

Mongoose的验证流程是先执行类型转换，再校验必填规则。当你提交空字符串""时，Mongoose会优先尝试把这个值转换成ObjectId类型，这一步直接失败抛出类型转换错误，根本没走到必填验证的环节，所以你的自定义错误信息无法触发。

解决办法 #

• 前端优化：确保未选择分类时，提交的category字段值为undefined或null，而非空字符串。Mongoose对undefined/null会直接跳过类型转换，进入必填校验逻辑，触发你设置的自定义错误信息。
• 后端补充验证：在Schema中添加自定义验证器，提前拦截空字符串的情况：

category: {
    type: ObjectId,
    ref: "Category",
    required: [true, "Recipe must belong to a category"],
    validate: {
        validator: function(v) {
            // 排除空字符串，确保只有有效ObjectId或null/undefined进入后续逻辑
            return v !== "";
        },
        message: "Recipe must belong to a category"
    }
},

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