Pipe 与校验

这一课你将能做到

1. 全局启用 ValidationPipe，配置 whitelist / forbidNonWhitelisted / transform
2. 用 class-validator 装饰器约束题目 DTO，非法请求体直接得到 400
3. 用 ParseIntPipe、ParseEnumPipe 等把路径与查询参数安全转换

为什么要学

Pipe（管道）人话：请求到达 Controller 方法之前，先做一次「转换」或「校验」。

最常用的是全局 ValidationPipe：它依据 DTO 上的装饰器检查 JSON——字段缺失、类型错误、选项数组为空、answerIndex 不是数字，都会被直接拦下并返回 400，业务方法根本看不到脏数据。这等于在每个接口入口统一设了一道关卡，而不是在每个方法里手写一堆 if。

它对应 Spring 的 @Valid 加 Bean Validation（JSR-303）：规则声明在字段上，框架负责执行。

先建立图像

HTTP JSON
  → ValidationPipe（whitelist / forbid / transform）
  → 合法：plain object 被构造成 CreateQuestionDto 实例
  → QuestionsController.create(dto)
  → QuestionsService

非法 → 400 + 字段级错误信息（进不了业务）

三个核心选项：

选项	人话解释
whitelist: true	自动剥掉 DTO 里没声明的字段
forbidNonWhitelisted: true	一旦多传未知字段，直接拒绝（400）
transform: true	把普通对象转成 DTO 类实例，并按参数类型做转换

跟着做

步骤 1：安装校验依赖

npm install class-validator class-transformer

class-validator 提供规则装饰器，class-transformer 负责把 JSON 对象转换成类实例，二者是 Nest 官方校验文档的标准搭档。

步骤 2：全局启用 ValidationPipe

修改 src/main.ts：

import { ValidationPipe } from "@nestjs/common";
import { NestFactory } from "@nestjs/core";
import { AppModule } from "./app.module";

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.setGlobalPrefix("api");
  app.useGlobalPipes(
    new ValidationPipe({
      whitelist: true,
      forbidNonWhitelisted: true,
      transform: true,
    }),
  );
  await app.listen(process.env.PORT ?? 3000);
}
bootstrap();

此后所有以 class 接收的 @Body() 都会自动校验。

步骤 3：给 CreateQuestionDto 加约束

替换 src/questions/dto/create-question.dto.ts：

import {
  ArrayMinSize,
  IsArray,
  IsEnum,
  IsInt,
  IsOptional,
  IsString,
  Max,
  MaxLength,
  Min,
  MinLength,
} from "class-validator";

export class CreateQuestionDto {
  @IsString()
  @MinLength(4, { message: "题干至少 4 个字符" })
  @MaxLength(500)
  stem: string;

  @IsArray()
  @ArrayMinSize(2, { message: "至少提供 2 个选项" })
  @IsString({ each: true })
  options: string[];

  @IsInt()
  @Min(0)
  @Max(7)
  answerIndex: number;

  @IsEnum(["easy", "medium", "hard"], {
    message: "difficulty 只能是 easy、medium、hard",
  })
  difficulty: "easy" | "medium" | "hard";

  @IsOptional()
  @IsArray()
  @IsString({ each: true })
  tags?: string[];
}