使用NestJS与class-transform序列化时@Transform执行两次且返回空值问题

以下是几种常见的排查和解决方向：

1. 排查是否重复注册了ClassSerializerInterceptor #

Nest的ClassSerializerInterceptor如果同时全局注册+局部（控制器/方法）注册，会导致序列化逻辑执行两次，自然@Transform会被触发两次。

• 全局注册示例（main.ts）：

app.useGlobalInterceptors(new ClassSerializerInterceptor(app.get(Reflector)));

• 局部注册示例（控制器/方法）：

@UseInterceptors(ClassSerializerInterceptor)
@Controller('users')
export class UsersController {}

解决：只保留一种注册方式，要么全局统一配置，要么仅在需要的控制器/方法上添加拦截器。

2. 检查自定义拦截器是否重复执行序列化 #

如果你写了自定义拦截器，并且在里面手动调用了classToPlain、plainToClass这类class-transform的方法，再加上Nest自带的ClassSerializerInterceptor，就会触发两次转换。

比如错误示例：

@Injectable()
export class CustomSerializerInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    return next.handle().pipe(
      map(data => classToPlain(data)), // 手动序列化
    );
  }
}

同时又用了ClassSerializerInterceptor，就会两次触发@Transform。

解决：二选一——要么删除自定义拦截器里的手动序列化逻辑，用Nest自带的拦截器；要么去掉ClassSerializerInterceptor，完全用自定义拦截器处理序列化。

3. 给@Transform添加toPlainOnly/toClassOnly限制 #

如果你的实体类同时用了TypeORM的@Entity和class-transform的装饰器，TypeORM加载实体时可能会触发一次class-transform的转换，然后Nest返回时再触发一次，第二次转换时可能因为字段已经被处理过导致缺失。

解决：在@Transform装饰器里指定仅在序列化到plain对象时执行（也就是返回给前端的时候）：

@Transform(({ value }) => value?.toString(), { toPlainOnly: true })
userId: number;

这样TypeORM加载实体的时候不会触发这个Transform，只有Nest序列化返回值时才执行一次。

4. 确保返回值只被处理一次 #

如果控制器返回的是Observable流，并且被多个操作符订阅/处理，可能会多次经过序列化拦截器。比如用了switchMap等操作符导致多次触发数据流。

解决：把Observable转为Promise后返回，确保只触发一次序列化：

async findOne(@Param('id') id: string) {
  const user$ = this.usersService.findOne(id);
  return lastValueFrom(user$);
}

内容的提问来源于stack exchange，提问作者小歌迷