React中向Mongoose批量存入对象数组及验证错误解决

问题背景 #

通过React+Axios向后端发送请求，req.body传递的newItemsObj是包含对象数组的结构，尝试存入关联MoneyInData的NewItemsData模型时，触发ValidationError，提示必填字段缺失。

相关代码片段 #

1. NewItemsData模型代码

const mongoose = require('mongoose');
const MoneyInData = require('./MoneyInData');

const newItemsSchema = new mongoose.Schema({
    productName:{
        type: String,
        required: true
    },
    sellingPriceOfTotal:{
      type: String,
      required: true
    },
    quantityCount: {
        type: Number
    },
    unitOfQuantity:{
        type: String
    },
    sellingPrice:{
        type: Number,
        required:true
    },
    sales:{
        type: mongoose.Schema.Types.ObjectId,
        ref: 'MoneyInData'
    }
})
module.exports = mongoose.model('NewItemsData', newItemsSchema);

2. MoneyInData模型代码

const mongoose = require ('mongoose')

const moneyInDataSchema = new mongoose.Schema({
    totalAmountIn:{
        type: String,
        required: true
    },
    amountRecieved:{
      type: String,
      required: true
    },
    balanceDue: {
        type: Number
    },
    itemDescription:{
        type: String
    },
    modeOfPayment:{
        type: String,
        required:true
    }
})
module.exports = mongoose.model('MoneyInData', moneyInDataSchema)

3. 后端创建接口代码

// @desc post newItems 
// @route POST /newItems
// @access Private
const createNewItems = asyncHandler(async (req, res) => {
    const  newItemsObj  = req.body
    console.log(newItemsObj)
    if (!newItemsObj) {
        return res.status(400).json({ message: 'All fields are required' })
    }
    const addNewItems = await NewItemsData.create(newItemsObj);

    if (addNewItems) {//created
        res.status(201).json({ message: 'New Item Recorded' })
        console.log(addNewItems)
        console.log(newItemsObj)
    } else {
        res.status(400).json({ message: 'Invalid Item' })
    }
})

4. 前端传递的样本数据

{
  newItemApiList: [
    {
      productName: 'molly',
      sellingPriceOfTotal: 17400,
      quantityCount: 3,
      unitOfQuantity: 'grams',
      sellingPrice: '5800'
    },
    {
      productName: 'group',
      sellingPriceOfTotal: 9000,
      quantityCount: 2,
      unitOfQuantity: 'cm',
      sellingPrice: '4500'
    }
  ]
}

错误信息

ValidationError: NewItemsData validation failed: sellingPrice: Path `sellingPrice` is required., sellingPriceOfTotal: Path `sellingPriceOfTotal` is required., productName: Path `productName` is required.
    at Document.invalidate (C:\Users\USER\Desktop\business-books\server\node_modules\mongoose\lib\document.js:3183:32)
    at C:\Users\USER\Desktop\business-books\server\node_modules\mongoose\lib\document.js:2976:17
    at C:\Users\USER\Desktop\business-books\server\node_modules\mongoose\lib\schematype.js:1368:9
    at process.processTicksAndRejections (node:internal/process/task_queues:77:11)

问题原因分析 #

1. 数据结构不匹配：后端直接把req.body（外层是包含newItemApiList的对象）传给NewItemsData.create()，但Mongoose的create()方法期望的是单个文档对象，或者文档对象数组，而非包含数组的外层对象，导致实际要存入的数组数据没被正确读取。
2. 字段类型不匹配：
   • 模型中sellingPriceOfTotal定义为String类型，但样本数据里是数字（17400、9000）
   • 模型中sellingPrice定义为Number类型，但样本数据里是字符串（'5800'、'4500'）

解决步骤 #

步骤1：修正数据结构并处理类型转换 #

修改后端接口代码，先提取出数组数据，再统一转换字段类型后批量创建：

const createNewItems = asyncHandler(async (req, res) => {
    // 取出实际的商品数组
    const { newItemApiList } = req.body;
    // 校验数组有效性
    if (!newItemApiList || !Array.isArray(newItemApiList) || newItemApiList.length === 0) {
        return res.status(400).json({ message: '至少需要一条商品数据' })
    }

    // 统一转换字段类型，匹配模型要求
    const formattedItems = newItemApiList.map(item => ({
        ...item,
        sellingPriceOfTotal: String(item.sellingPriceOfTotal), // 转字符串
        sellingPrice: Number(item.sellingPrice) // 转数字
    }));

    try {
        // 批量创建文档
        const addNewItems = await NewItemsData.create(formattedItems);
        res.status(201).json({ 
            message: `成功录入${addNewItems.length}条商品记录`,
            data: addNewItems
        });
    } catch (error) {
        // 捕获验证错误，返回详细提示
        if (error.name === 'ValidationError') {
            const errors = Object.values(error.errors).map(err => err.message);
            return res.status(400).json({ message: '数据验证失败', errors });
        }
        res.status(500).json({ message: '服务器内部错误' });
    }
})

步骤2：（可选）优化模型字段类型 #

如果业务允许，也可以直接调整模型字段类型，适配前端传递的数据格式：

// NewItemsData模型调整
sellingPriceOfTotal:{
  type: Number, // 改为数字类型
  required: true
},
sellingPrice:{
  type: Number,
  required:true,
  set: val => Number(val) // 自动将字符串转为数字
}

步骤3：（可选）前端提前校验数据 #

在前端发送请求前，先校验并转换字段类型，减少后端压力：

// React中处理请求前的数据
const handleSubmit = async () => {
    const formattedList = newItemApiList.map(item => ({
        ...item,
        sellingPriceOfTotal: item.sellingPriceOfTotal.toString(),
        sellingPrice: parseInt(item.sellingPrice)
    }));
    try {
        await axios.post('/newItems', { newItemApiList: formattedList });
        // 处理成功逻辑
    } catch (err) {
        // 处理错误提示
    }
}

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