如何在NestJS中通过Multer自动将文件保存到指定目录？

以下是针对你遇到的MulterModule配置后文件未自动保存、目录未创建问题的排查和解决步骤：

• 确认MulterModule的正确导入
  检查你的导入来源是否为NestJS官方包，正确的导入应该是：

  import { MulterModule } from '@nestjs/platform-express';
  

  代码中使用的MulterModuleLib如果是自定义封装的模块，需要确认其内部是否正确传递了dest配置到官方MulterModule。

• 使用绝对路径避免工作目录问题
  相对路径./uploads会依赖Node进程的工作目录，若你是从dist目录启动项目，实际路径会变成dist/uploads，导致目录创建位置不符合预期。建议用path模块生成绝对路径：

  import * as path from 'path';
  
  @Module({
    imports: [
      MulterModule.register({
        dest: path.join(__dirname, '../uploads')
      })
    ]
  })
  export class AppModule {}
  

• 确保控制器正确使用文件拦截器
  模块配置生效的前提是控制器中使用了对应的文件拦截器装饰器，比如单文件上传：

  import { Controller, Post, UseInterceptors, UploadedFile } from '@nestjs/common';
  import { FileInterceptor } from '@nestjs/platform-express';
  
  @Controller('upload')
  export class UploadController {
    @Post()
    @UseInterceptors(FileInterceptor('file'))
    uploadFile(@UploadedFile() file: Express.Multer.File) {
      return { filePath: file.path };
    }
  }
  

  注意FileInterceptor('file')中的file要和前端表单的文件字段名完全一致。

• 检查目录权限
  确保运行Node进程的用户拥有在项目目录下创建文件夹和写入文件的权限，Linux/macOS下可通过chmod调整权限，Windows下需确认文件夹没有被设置为只读。

• 避免自定义存储引擎覆盖配置
  若你同时配置了storage选项，dest会被忽略，此时要确保diskStorage中的destination配置正确：

  import { diskStorage } from 'multer';
  
  MulterModule.register({
    storage: diskStorage({
      destination: './uploads',
      filename: (req, file, cb) => {
        cb(null, file.originalname);
      }
    })
  })
  

• 验证请求格式
  前端发送的请求必须是multipart/form-data类型，使用Postman等工具测试时，需选择form-data格式，并将字段类型设置为File后再上传文件。

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