在NextJS中使用multer+next-connect时遇Stream及运行错误求助

问题根源 #

你遇到的核心问题是Edge Runtime不支持Node.js核心模块（如Stream），而multer依赖Node.js的Stream和文件系统API。用stream-browserify做polyfill会因为浏览器/Edge环境的Stream实现和Node.js不兼容，反而引发序列化错误和slice调用失败。

正确解决方案 #

1. 强制使用Node.js Runtime

在你的API路由文件顶部添加一行配置，指定使用Node.js运行时（而非默认的Edge），这样就能直接用Node.js的Stream，不用任何polyfill：

// app/api/your-route/route.ts 或 pages/api/your-route.ts
export const runtime = 'nodejs'; // 关键配置

import nc from 'next-connect';
import multer from 'multer';

// 配置multer存储（示例用本地存储，可根据需求调整）
const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, './public/uploads'); // 确保uploads目录存在
  },
  filename: (req, file, cb) => {
    cb(null, `${Date.now()}-${file.originalname}`);
  }
});

const upload = multer({ storage });

// 用next-connect创建处理函数
const handler = nc()
  .use(upload.single('file')) // 匹配前端上传的字段名，比如form里的name="file"
  .post((req, res) => {
    // 这里可以安全访问req.file，不会出现undefined的情况（只要前端字段名匹配）
    if (!req.file) {
      return res.status(400).json({ error: 'No file uploaded' });
    }
    res.status(200).json({ 
      message: 'File uploaded',
      file: {
        name: req.file.filename,
        path: req.file.path
      }
    });
  });

export { handler as POST };

2. 清理不必要的依赖和配置

• 卸载stream-browserify：

  npm uninstall stream-browserify
  # 或 yarn remove stream-browserify
  

• 删除webpack配置中关于stream的alias或polyfill配置，比如类似这样的代码要删掉：

  // next.config.js 中相关代码移除
  module.exports = {
    webpack: (config) => {
      // 删掉这部分
      config.resolve.alias = {
        ...config.resolve.alias,
        stream: 'stream-browserify'
      };
      return config;
    }
  };
  

3. 排查TypeError: Cannot read properties of undefined (reading 'slice')

这个错误大概率是因为req.file为undefined，原因可能是：

• 前端上传的表单字段名和multer.single('xxx')中的xxx不匹配，比如前端写的是name="upload"，但代码里是single('file')，导致multer没识别到文件。
• 没有正确配置multer的存储方式，导致文件无法被解析。

额外注意 #

• 如果用的是Pages Router（pages/api下的路由），默认就是Node.js运行时，不需要加runtime配置，直接用multer和next-connect即可。
• 确保public/uploads目录存在，否则multer会报错，可手动创建或在代码里加目录判断。

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