如何复用Multer配置为特定路由指定不同的上传文件夹

嘿，我来帮你搞定这个问题！你已经在全局配置好了Multer的基础上传逻辑，现在想给特定路由指定uploads/category这个子文件夹，又不想重复写一大段存储配置代码，对吧？这里有几个优雅的解决方案，既能复用现有逻辑，又能满足需求：

方案一：抽离可复用的存储配置函数（最常用） #

核心思路是把你原来写的diskStorage逻辑抽成一个可复用的工具函数，这样全局配置和路由局部配置都能调用它，只需要传入不同的路径参数就行。

首先，创建一个工具文件（比如src/common/utils/multer.utils.ts），把存储逻辑封装起来：

import { diskStorage } from 'multer';
import { ConfigService } from '@nestjs/config';
import { Request } from 'express';

export const getMulterStorage = (configService: ConfigService, subFolder?: string) => {
  // 获取全局配置的基础上传文件夹
  const baseUploadFolder = configService.get<string>('uploadFolder');
  // 拼接子文件夹路径（如果有的话）
  const finalDestination = subFolder ? `${baseUploadFolder}/${subFolder}` : baseUploadFolder;

  return diskStorage({
    destination: finalDestination,
    filename(req: Request, file: Express.Multer.File, cb: (error: Error | null, filename: string) => void) {
      // 复用你原来的文件名生成逻辑
      const filename = `${Date.now()}-${file.originalname}`;
      cb(null, filename);
    },
  });
};

然后修改AppModule里的全局Multer配置，使用这个工具函数：

MulterModule.registerAsync({
    imports: [ ConfigModule ],
    inject: [ ConfigService ],
    async useFactory(configService: ConfigService) {
        return {
            storage: getMulterStorage(configService), // 不传subFolder，用全局默认路径
        };
    }
}),

接下来在CategoryController里，通过FileInterceptor的第二个参数局部覆盖存储配置，同时注入ConfigService来使用工具函数：

import { Controller, Post, UseInterceptors, UploadedFile, Inject } from '@nestjs/common';
import { FileInterceptor } from '@nestjs/platform-express';
import { ConfigService } from '@nestjs/config';
import { getMulterStorage } from '../common/utils/multer.utils'; // 导入工具函数

@Controller("category")
export class CategoryController
{
    constructor(@Inject(ConfigService) private readonly configService: ConfigService) {}

    @UseInterceptors(FileInterceptor("image", {
        storage: getMulterStorage(this.configService, 'category') // 指定子文件夹为category
    }))
    @Post()
    async create(
        @UploadedFile(
            new ParseFilePipeBuilder()
                .addFileTypeValidator({ fileType: ALLOWED_IMAGE_TYPES.join() })
                .addMaxSizeValidator({ maxSize: MAX_FILE_SIZE_BYTES })
                .build({
                    fileIsRequired: false,
                    errorHttpStatusCode: HttpStatus.UNPROCESSABLE_ENTITY
                })
        )
        image
    )
    {
        console.log(image); // 此时image的存储路径已经是uploads/category/xxx了
    }
}

这样就完全复用了原来的文件名生成逻辑，只需要传入不同的子文件夹参数，没有重复代码！

方案二：模块级别配置Multer（适合整个模块用同一路径） #

如果你的整个CategoryModule下的所有路由都需要上传到uploads/category，可以直接在模块级别配置Multer，这样模块内的所有拦截器都会自动使用这个配置：

在CategoryModule里添加Multer的模块配置：

import { Module } from '@nestjs/common';
import { MulterModule } from '@nestjs/platform-express';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { getMulterStorage } from '../common/utils/multer.utils';
import { CategoryController } from './category.controller';

@Module({
  imports: [
    MulterModule.registerAsync({
      imports: [ConfigModule],
      inject: [ConfigService],
      useFactory: (configService: ConfigService) => ({
        storage: getMulterStorage(configService, 'category'),
      }),
    }),
  ],
  controllers: [CategoryController],
})
export class CategoryModule {}

之后CategoryController里的FileInterceptor就不需要额外指定storage了，直接用模块配置好的规则就行，代码更简洁。

方案三：动态生成路径（适合根据请求参数变化的场景） #

如果你的子文件夹需要根据请求里的参数动态生成（比如根据分类ID、用户ID），可以修改工具函数，支持通过请求对象获取动态路径：

更新getMulterStorage函数：

import { diskStorage } from 'multer';
import { ConfigService } from '@nestjs/config';
import { Request } from 'express';
import * as fs from 'fs';

export const getMulterStorage = (
  configService: ConfigService,
  getSubFolder?: (req: Request) => string
) => {
  const baseUploadFolder = configService.get<string>('uploadFolder');

  return diskStorage({
    destination(req: Request, file: Express.Multer.File, cb: (error: Error | null, path: string) => void) {
      let finalDestination = baseUploadFolder;
      // 如果传入了动态获取子文件夹的函数，就拼接路径
      if (getSubFolder) {
        const subFolder = getSubFolder(req);
        finalDestination = `${finalDestination}/${subFolder}`;
      }
      // 确保文件夹存在，不存在就自动创建（递归创建多级目录）
      fs.mkdirSync(finalDestination, { recursive: true });
      cb(null, finalDestination);
    },
    filename(req: Request, file: Express.Multer.File, cb: (error: Error | null, filename: string) => void) {
      const filename = `${Date.now()}-${file.originalname}`;
      cb(null, filename);
    },
  });
};

然后在Controller里使用时，传入动态获取子文件夹的逻辑：

@UseInterceptors(FileInterceptor("image", {
  storage: getMulterStorage(this.configService, (req) => {
    // 比如从请求体或URL参数里获取分类ID，生成动态路径
    const categoryId = req.body.categoryId;
    return `category/${categoryId}`;
  }),
}))

这样就能实现完全动态的上传路径，同时依然复用了核心的配置逻辑。

总结一下：不管用哪种方案，核心都是把重复的Multer存储逻辑抽离成可复用的单元，然后通过参数传递来改变存储路径，避免代码冗余。

备注：内容来源于stack exchange，提问作者Oliver Patterson