如何为NestJS创建响应DTO？实现类型化响应返回

步骤1：定义数据子DTO #

先创建响应里data字段对应的具体结构DTO，比如示例中的用户数据结构：

// src/dtos/user-data.dto.ts
export class UserDataDto {
  id: number;
}

步骤2：定义全局响应DTO #

根据你当前的返回结构，创建顶层的SuccessDto，关联刚才的子DTO：

// src/dtos/success.dto.ts
import { UserDataDto } from './user-data.dto';

export class SuccessDto {
  statusCode: number;
  message: string;
  data: UserDataDto;
}

步骤3：在业务代码中使用 #

在Service或Controller里直接指定返回类型为Promise<SuccessDto>，并按DTO结构返回数据：

// 示例Service代码
import { SuccessDto } from './dtos/success.dto';
import { UserDataDto } from './dtos/user-data.dto';

async test(): Promise<SuccessDto> {
  const data: UserDataDto = { id: 10 };
  return {
    statusCode: 200,
    message: 'success',
    data,
  };
}

可选：添加数据验证（更严谨的写法） #

配合class-validator和class-transformer给DTO添加校验规则，确保返回数据符合预期格式：

// 修改user-data.dto.ts
import { IsNumber } from 'class-validator';

export class UserDataDto {
  @IsNumber()
  id: number;
}

// 修改success.dto.ts
import { IsNumber, IsString, ValidateNested } from 'class-validator';
import { Type } from 'class-transformer';
import { UserDataDto } from './user-data.dto';

export class SuccessDto {
  @IsNumber()
  statusCode: number;

  @IsString()
  message: string;

  @ValidateNested()
  @Type(() => UserDataDto)
  data: UserDataDto;
}

这样就能像定义输入DTO一样，严格约束响应的结构和类型了。

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