Mongoose新增产品时category字段转ObjectId失败报错排查

新增产品详情调用提交接口时返回JSON类型报错，错误触发时机为提交category字段时，完整报错信息：

Cast to ObjectId failed for value "" (type string) at path "category" because of "BSONTypeError"

当前除category字段外，其余产品详情字段均可正常写入MongoDB数据表，仅category字段写入时触发上述类型转换错误。

产品Schema中category字段定义为关联Category集合的ObjectId类型，相关代码如下：

const mongoose = require("mongoose");
const { ObjectId } = mongoose.Schema;

// 产品Schema字段片段
{
  category: {
    type: ObjectId,
    ref: "Category",
  },
};

提交到后端的category字段值为空字符串""，Mongoose无法将空字符串转换为符合BSON规范的ObjectId类型，因此抛出类型转换异常。

• 前端入参校验：提交产品表单前先校验分类选择状态，未选中分类时不要传递空字符串，要么不传该字段，要么传null；如果分类为必填项，直接在前端拦截提示用户选择分类后再提交。
• 后端入参清洗：接口接收到请求参数后先做格式预处理，把category字段的空字符串、非24位十六进制格式的非法值统一处理，示例逻辑：

// 入参清洗逻辑
const submitData = req.body;
// 空字符串场景处理
if (typeof submitData.category === 'string' && submitData.category.trim() === '') {
  delete submitData.category;
}
// 若分类为必填项，直接返回参数错误
if (!submitData.category) {
  return res.status(400).json({ msg: '请选择产品分类' });
}

• Schema配置优化：根据业务规则调整字段约束，避免异常值触发转换错误：
  • 允许分类为空的场景：给字段加default: null配置，空值时自动写入null不会触发转换错误
  • 分类为必填的场景：给字段加required: [true, "产品分类不能为空"]约束，Mongoose会提前做必填校验返回明确错误，不会走到ObjectId转换逻辑

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