Multer-GridFS报错TypeError: Cannot read '_id' of undefined 排查求助

我正在开发一款WhatsApp克隆应用，实现文件分享功能时遇到了后端崩溃问题。用户上传文件后，文件确实能保存到MongoDB，但后端会触发错误导致崩溃，报错信息如下：

C:\Users\user\OneDrive\Documents\webdev\whatsapp clone self\server\node_modules\multer-gridfs-storage\lib\gridfs.js:306
                        id: f._id,
                              ^

TypeError: Cannot read properties of undefined (reading '_id')       
    at GridFSBucketWriteStream.emitFile (C:\Users\Siddh\OneDrive\Documents\webdev\whatsapp clone self\server\node_modules\multer-gridfs-storage\lib\gridfs.js:306:31)
    at GridFSBucketWriteStream.emit (node:events:526:35)
    at finish (node:internal/streams/writable:807:10)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)

Node.js v20.9.0
[nodemon] app crashed - waiting for file changes before starting...

相关代码片段：

前端API调用（api.js）

export const uploadFile = async (data) => {
    try {
        return await axios.post(`${url}/file/upload`, data);
    } catch (error) {
        console.log('Error while calling uploadfile API ', error);
    }
}

后端控制器（controller）

const url = 'http://localhost:8000';
export const uploadFile = async(request, response)=>{
    if(!request.file){
        return response.status(404).json("file not found")
    }
    const imageUrl = `${url}/file/${request.file.filename}`;
    return response.status(200).json(imageUrl);
}

后端路由（route.js）

//Route for file upload
route.post('/file/upload', upload.single("file"), uploadFile);

可能的原因及解决步骤 #

1. 依赖版本不兼容 #

你使用的Node.js v20.9.0属于较新版本，而multer-gridfs-storage旧版本可能对新版MongoDB驱动（如mongodb@5.x+）的API适配存在问题，导致文件写入完成后无法正确获取文件对象f。

解决方法：

• 升级multer-gridfs-storage到最新稳定版：

  npm update multer-gridfs-storage
  

• 若升级后问题仍存在，锁定MongoDB驱动为兼容版本（如mongodb@4.17.0）：

  npm install mongodb@4.17.0
  

2. GridFS存储配置错误 #

检查multer-gridfs-storage的初始化代码，确认是否正确配置了MongoDB连接和Bucket信息，比如是否遗漏bucketName，或连接字符串有误，导致文件写入后无法正确检索元数据。

示例正确配置：

const { GridFsStorage } = require('multer-gridfs-storage');
const storage = new GridFsStorage({
  url: 'mongodb://localhost:27017/whatsapp-clone',
  file: (req, file) => {
    return new Promise((resolve, reject) => {
      const filename = file.originalname;
      const fileInfo = {
        filename: filename,
        bucketName: 'uploads' // 确保该Bucket在数据库中存在
      };
      resolve(fileInfo);
    });
  }
});
const upload = multer({ storage });

3. 文件元数据校验缺失 #

错误栈显示问题出在文件对象的_id读取，可在控制器中增加元数据校验，避免未完成初始化的文件对象触发后续逻辑：

export const uploadFile = async(request, response)=>{
    if(!request.file){
        return response.status(404).json("file not found")
    }
    // 校验文件元数据是否完整
    if (!request.file.id) {
      return response.status(500).json("Failed to retrieve file metadata");
    }
    const imageUrl = `${url}/file/${request.file.filename}`;
    return response.status(200).json(imageUrl);
}

4. Node.js版本适配问题 #

Node.js v20的Stream API变化可能影响multer-gridfs-storage内部处理，可尝试降级到Node.js v18 LTS版本，验证问题是否消失。

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