在 Nest.js 中实现文件上传

文件上传是后端开发中非常常见的需求,例如用户上传头像、Excel 报表、图片资源等。Nest.js 作为一个基于 TypeScript 的渐进式 Node.js 框架,提供了开箱即用的上传支持,并且与 Multer 中间件深度集成。

本文将介绍 Nest.js 中文件上传的实现方式。


1. 文件上传的原理

Nest.js 本身并不直接处理文件,而是通过 Multer 来解析 multipart/form-data 类型的请求。Nest.js 提供了内置的拦截器(Interceptor),可以很方便地将上传逻辑融入到控制器中。

核心要点:

  • 使用 @UseInterceptors() 配合 FileInterceptorFilesInterceptor
  • 上传后的文件会自动保存到磁盘(或内存),并在控制器方法中以参数形式注入。
  • 可以自定义存储路径、文件名、过滤器等。

2. 单文件上传

首先安装依赖:

bash 复制代码
npm install @nestjs/platform-express multer

控制器代码示例:

ts 复制代码
import {
  Controller,
  Post,
  UploadedFile,
  UseInterceptors,
} from "@nestjs/common";
import { FileInterceptor } from "@nestjs/platform-express";
import { diskStorage } from "multer";
import { extname } from "path";

@Controller("upload")
export class UploadController {
  @Post("single")
  @UseInterceptors(
    FileInterceptor("file", {
      storage: diskStorage({
        destination: "./uploads", // 文件保存路径
        filename: (req, file, callback) => {
          const uniqueSuffix =
            Date.now() + "-" + Math.round(Math.random() * 1e9);
          callback(null, `${uniqueSuffix}${extname(file.originalname)}`);
        },
      }),
      limits: { fileSize: 5 * 1024 * 1024 }, // 限制 5MB
    })
  )
  uploadSingle(@UploadedFile() file: Express.Multer.File) {
    return {
      filename: file.filename,
      path: file.path,
    };
  }
}

说明:

  • FileInterceptor('file') 对应前端表单里的 name="file"
  • diskStorage 用于定义保存目录和文件命名规则。
相关推荐
前端小书生10 小时前
MongoDB、NestJS 集成 @nestjs/mongoose
mongodb·nestjs
前端小书生11 小时前
NestJs
前端·nestjs
濮水大叔12 小时前
Vona ORM分表全攻略
typescript·node.js·nestjs
濮水大叔2 天前
在Vona ORM中实现多数据库/多数据源
typescript·nodejs·nestjs
无双_Joney8 天前
[更新迭代 - 1] Nestjs 在24年底更新了啥?(功能篇)
前端·后端·nestjs
麻辣小蜗牛9 天前
以 NestJS 为原型看懂 Node.js 框架设计:Module
nestjs
irving同学4623816 天前
TypeORM 列装饰器完整总结
前端·后端·nestjs
Wang's Blog18 天前
Nestjs框架: 基于策略的权限控制(ACL)与数据权限设计
nestjs·rbac·acl
三十_18 天前
【NestJS】构建可复用的数据存储模块 - 动态模块
前端·后端·nestjs