class-transformer嵌套类转换问题：嵌套DTO转换失效求优化方案

输入对象 #

const input = {
  "steps": [{ "id": 1 }, { "id": 2 }],
  "foo": "bar",
  "currentStep": { "id": 1 }
}

现有DTO代码 #

import { Expose, Transform, Type } from 'class-transformer';

export class StepDTO {
  @Expose()
  @Transform(({ obj }) => obj.id)
  transformedFoo: number;
}

export class MainDTO {
  @Expose()
  @Transform(({ obj }) => obj.foo)
  transformedFoo: number;

  @Expose()
  @Transform(({ obj }) => obj.steps)
  @Type(() => StepDTO)
  updatedSteps: StepDTO[];

  @Expose()
  @Transform(({ obj }) => obj.steps[0])
  @Type(() => StepDTO)
  currentStep: StepDTO;
}

const transformed = plainToInstance(
  MainDTO,
  input,
  { excludeExtraneousValues: true }
);

问题现象 #

转换后主DTO的transformedFoo字段正常，但嵌套的StepDTO未生效，结果仍保留原对象的id字段，未转换成transformedFoo：

{"transformedFoo":"bar","updatedSteps":[{"id":1},{"id":2}],"currentStep":{"id":1}}

临时方案（不够简洁） #

手动在Transform中调用plainToInstance处理嵌套转换：

@Expose()
@Transform(({ obj }) =>
  plainToInstance(StepDTO, obj.steps, { excludeExtraneousValues: true })
)
@Type(() => StepDTO)
updatedSteps: StepDTO[];

更优实现方案 #

核心原因 #

@Transform装饰器优先级高于@Type，当在@Transform中直接返回原始数组/对象时，class-transformer会跳过@Type指定的自动类型转换逻辑，导致嵌套DTO不生效。

优化后的DTO代码 #

import { Expose, Transform, Type } from 'class-transformer';

export class StepDTO {
  @Expose()
  @Transform(({ obj }) => obj.id)
  transformedFoo: number;
}

export class MainDTO {
  @Expose({ name: 'foo' })
  transformedFoo: string;

  @Expose({ name: 'steps' })
  @Type(() => StepDTO)
  updatedSteps: StepDTO[];

  @Expose()
  @Type(() => StepDTO)
  @Transform(({ obj }) => obj.steps[0])
  currentStep: StepDTO;
}

const transformed = plainToInstance(
  MainDTO,
  input,
  { excludeExtraneousValues: true }
);

关键优化点 #

1. 字段映射用@Expose(name)替代Transform：对于简单的字段重命名（如foo→transformedFoo、steps→updatedSteps），使用@Expose({ name: 原字段名 })更简洁，且不会干扰嵌套类型转换。
2. 仅在必要时保留Transform：currentStep需要从steps[0]取值，保留@Transform但仅返回原始对象，@Type会自动对返回值进行StepDTO转换。
3. 移除多余的Transform：删除updatedSteps上的@Transform(({ obj }) => obj.steps)，让@Type自动处理数组到StepDTO[]的转换。

转换后正确结果：

{"transformedFoo":"bar","updatedSteps":[{"transformedFoo":1},{"transformedFoo":2}],"currentStep":{"transformedFoo":1}}

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