NestJS中含关联实体的DTO设计最佳实践咨询

问题背景 #

我正在处理人员相关的实体，人员间存在亲属关联关系，定义的 Person 实体如下：

@Entity()
export class Person {
  @Column({ length: 100 })
  name: string;

  @Column({ length: 20 })
  document: string;

... 
and many other properties
...

  @ManyToOne(() => Person, { nullable: true })
  @JoinColumn({
    name: 'father_id',
    foreignKeyConstraintName: 'fk_person_father',
  })
  father: Person;

  @ManyToOne(() => Person, { nullable: true })
  @JoinColumn({
    name: 'mother_id',
    foreignKeyConstraintName: 'fk_person_mother',
  })
  mother: Person; // 注：原代码中此处误写为father，已修正
}

当前使用的 CreatePersonDto 如下：

export class CreatePersonDto {
  name: string;
  document: string;
...
  father: Person;
  mother: Person;
}

问题在于使用该 DTO 时，必须传入父亲、母亲的完整属性，但实际仅需传入其 ID 即可建立关联。现有三种解决方案：

1. 将 Person 的所有属性设为可选（如 name?: string、document?: string 等）
2. 创建仅 ID 为必填、其余属性可选的 GetPersonDTO
3. 将 DTO 中的 father、mother 属性改为 number 类型

请问哪种方案是 NestJS 中的最佳实践？

最佳实践分析 #

方案2是NestJS中最符合规范的最佳实践，具体分析如下：

方案1的弊端 #

把Person实体的所有属性设为可选，会直接破坏实体本身的约束——实体代表数据库表结构，字段的必填性是业务和数据库层面的规则，不能为了DTO的便利修改实体定义，这会导致实体失去原本的语义，后续在其他场景使用实体时容易出现逻辑错误。

方案3的问题 #

将father、mother改为number类型，虽然能满足当前创建场景的需求，但有两个明显缺陷：

• 语义不清晰：从DTO字段名father来看，类型是number会让其他开发者困惑，无法直观理解这个数字的含义；
• 扩展性差：如果后续需要在创建时传入亲属的其他基础信息（比如姓名用于校验），这种方案就无法满足，必须重新修改DTO结构。

方案2的优势 #

创建一个仅包含ID（必填）、其余属性可选的PersonReferenceDto（或你所说的GetPersonDTO），是最贴合NestJS和TypeORM最佳实践的方式：

1. 语义明确：DTO字段father: PersonReferenceDto清晰表明这是一个人员引用，只需要ID就能建立关联；
2. 解耦实体与DTO：实体和DTO职责分离，实体维护数据库约束，DTO适配业务场景的输入需求；
3. 扩展性强：后续如果需要增加校验（比如传入父亲的姓名做一致性验证），只需要在PersonReferenceDto中添加可选属性即可，无需修改实体或核心DTO；
4. 符合TypeORM关联逻辑：TypeORM在处理ManyToOne关联时，允许传入仅包含ID的实体对象，框架会自动提取ID建立外键关联，不需要完整的实体实例。

示例代码如下：

// PersonReferenceDto.ts
import { IsNotEmpty } from 'class-validator';

export class PersonReferenceDto {
  @IsNotEmpty()
  id: number;
  
  // 可选：如果需要其他基础属性用于校验，可添加
  // name?: string;
}

// CreatePersonDto.ts
import { IsNotEmpty, IsOptional, ValidateNested } from 'class-validator';
import { Type } from 'class-transformer';
import { PersonReferenceDto } from './person-reference.dto';

export class CreatePersonDto {
  @IsNotEmpty()
  name: string;

  @IsNotEmpty()
  document: string;

...
  @ValidateNested()
  @IsOptional()
  @Type(() => PersonReferenceDto)
  father: PersonReferenceDto;

  @ValidateNested()
  @IsOptional()
  @Type(() => PersonReferenceDto)
  mother: PersonReferenceDto;
}

在Service层处理时，只需把DTO中的亲属引用转换为带ID的实体对象即可：

async create(createPersonDto: CreatePersonDto) {
  const person = this.personRepository.create({
    ...createPersonDto,
    father: createPersonDto.father ? { id: createPersonDto.father.id } : null,
    mother: createPersonDto.mother ? { id: createPersonDto.mother.id } : null,
  });
  return this.personRepository.save(person);
}

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