为何我的房产信息上传模块无法保存图片详情？

错误根源 #

这个RangeError: offset is out of bounds是BSON序列化Buffer时触发的异常，核心问题是你存入MongoDB的images/videos数据格式不符合Mongoose Schema定义，或是直接传递了multer生成的完整File对象（包含Buffer以外的冗余字段），导致序列化失败。

排查与解决步骤 #

1. 核对Mongoose Schema定义 #

确保images和videos字段被定义为Buffer数组，示例：

const propertySchema = new mongoose.Schema({
  // 其他字段（如name、location等）省略
  images: [{ type: Buffer }],
  videos: [{ type: Buffer }]
});

const propertyModel = mongoose.model('Property', propertySchema);

如果Schema中这两个字段的类型是String或其他非Buffer类型，但你传入了Buffer数据，就会触发序列化错误。

2. 正确处理multer上传的文件数据 #

使用memoryStorage时，multer将文件存储在req.files（多文件场景）或req.file（单文件场景）中，每个文件对象包含buffer、originalname等属性。不能直接将整个File对象存入数据库，需要提取其中的buffer部分：

// 假设你的路由使用了multer的fields方法处理多文件上传
const images = req.files.images ? req.files.images.map(file => file.buffer) : [];
const videos = req.files.videos ? req.files.videos.map(file => file.buffer) : [];

3. 验证数据类型正确性 #

在创建document之前，打印验证images和videos是否为纯Buffer数组：

console.log('Images are all buffers:', images.every(img => Buffer.isBuffer(img)));
console.log('Videos are all buffers:', videos.every(vid => Buffer.isBuffer(vid)));

如果输出为false，说明存在非Buffer数据，需要过滤或转换格式。

4. 更新依赖包（可选） #

旧版本的bson或mongoose可能存在序列化Bug，尝试更新依赖：

npm update bson mongoose

修正后的完整示例代码 #

// 路由处理函数示例
app.post('/upload-property', upload.fields([
  { name: 'images', maxCount: 5 },
  { name: 'videos', maxCount: 2 }
]), async (req, res) => {
  try {
    const { name, location, description, price, area, bedroom, bathroom, owner, type, city } = req.body;
    // 提取文件buffer
    const images = req.files.images?.map(f => f.buffer) || [];
    const videos = req.files.videos?.map(f => f.buffer) || [];

    const propertyDoc = new propertyModel({
      _id: isVerified.userId,
      name,
      location,
      description,
      price,
      area,
      bedroom,
      bathroom,
      owner,
      type,
      city,
      images,
      videos
    });

    await propertyDoc.save();
    res.status(201).json({ success: true, message: '房产信息保存成功' });
  } catch (err) {
    console.error('保存失败:', err);
    res.status(500).json({ success: false, error: '内部服务器错误' });
  }
});

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