Node.js Cloudinary商品创建时图片上传报错：Cannot read properties of undefined (reading 'length')

1. 核心错误：未处理req.body.images不存在的场景 #

当请求中没有携带images字段时，req.body.images的值为undefined，你的代码会进入else分支将images赋值为undefined，后续循环中访问images.length就会抛出Cannot read properties of undefined (reading 'length')错误。

2. 次要错误：Model.create参数传递错误 #

productsModel.create()要求接收一个完整的对象参数，但你传入了两个独立参数req.body.images和req.body.user，这会导致商品创建时数据不完整，甚至无法正确生成记录。

修复后的代码 #

// Creando productos
export const newProduct = catchAsyncErrors(async (req, res, next) => {
    // 初始化images数组，兼容未传图片、单张图片、多张图片的场景
    let images = [];
    if (req.body.images) { // 先判断images字段是否存在
        if (typeof req.body.images === 'string') {
            images.push(req.body.images);
        } else {
            images = req.body.images;
        }
    }

    let imagesLinks = [];

    // 仅当images有内容时执行Cloudinary上传逻辑
    for (let i = 0; i < images.length; i++) {
        const result = await cloudinary.v2.uploader.upload(images[i], {
            folder: 'products',
        });

        imagesLinks.push({
            public_id: result.public_id,
            url: result.secure_url,
        });
    }

    req.body.images = imagesLinks;
    req.body.user = req.user.id;
    // 传递完整的req.body对象给create方法
    const product = await productsModel.create(req.body);
    res.status(201).json({
        success: true,
        data: product,
    });
});

额外优化建议 #

• 添加参数校验：用Joi或Express Validator验证images字段格式（确保是字符串或数组），提前拦截非法请求。
• 处理上传异常：给Cloudinary上传逻辑添加try-catch，避免单个图片上传失败导致整个商品创建流程中断。

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