NestJS使用MulterModule上传文件请求无限挂起求助

问题复现 #

使用NestJS的MulterModule配合@UseInterceptors(FileInterceptor())实现文件上传时，所有请求陷入无限挂起状态；但直接在main.ts中通过app.use(multer({dest: "./upload"}).single("file"))却能正常工作。已排除前端问题，测试过NestJS v9、Multer 1.4.4/1.4.5版本，关闭ValidationPipe的whitelist: true无效。

可能的原因及解决方法 #

1. 上传目录不存在或权限不足 #

Multer需要将文件写入指定的dest目录，若目录未创建或应用无读写权限，会导致请求阻塞。

• 手动创建./upload目录，并确保应用拥有该目录的读写权限；
• 或配置storage选项自动创建目录：

import { diskStorage } from 'multer';
import { mkdirp } from 'mkdirp'; // 需安装 mkdirp 依赖

MulterModule.register({
  storage: diskStorage({
    destination: async (req, file, cb) => {
      const uploadDir = './upload';
      await mkdirp(uploadDir);
      cb(null, uploadDir);
    },
    filename: (req, file, cb) => {
      cb(null, file.originalname);
    },
  }),
});

2. 文件大小超出Multer默认限制 #

Multer默认限制文件大小为1MB，若上传文件超过此值，会导致请求挂起无响应。可调整limits参数：

MulterModule.register({
  dest: './upload',
  limits: {
    fileSize: 10 * 1024 * 1024, // 设置为10MB
  },
});

3. 全局拦截器/过滤器破坏请求流 #

全局拦截器若修改了multipart/form-data类型的请求体，会干扰Multer的解析流程。可在全局拦截器中跳过这类请求：

@Injectable()
export class GlobalInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    const req = context.switchToHttp().getRequest();
    // 跳过multipart/form-data请求的拦截处理
    if (req.headers['content-type']?.startsWith('multipart/form-data')) {
      return next.handle();
    }
    // 其他业务逻辑
  }
}

4. 临时排查DTO验证问题 #

暂时注释掉@Body() body: DtoSaveCustomerFile，测试请求是否能进入控制器。若可以，说明DTO的字段定义或验证规则存在隐性问题，需逐步排查DTO的每个字段。

5. 确认MulterModule正确导入 #

确保AppModule的imports数组中正确注册了MulterModule：

@Module({
  imports: [
    MulterModule.register({
      dest: './upload',
    }),
    // 其他模块
  ],
})
export class AppModule {}

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