NestJS嵌套数组对象序列化不生效 自定义字段返回空问题

当前代码存在4个核心问题，直接导致嵌套数组场景下字段值为空：

• 冗余定义的logo_img_url属性是类实例化阶段就赋值的，这个时机logo_key还没有被TypeORM查询结果、class-transformer转换逻辑填充，拿到的值是空，后续logo_key赋值后这个静态初始化的值不会自动更新
• @Expose装饰器放错位置：getter方法默认导出的字段名是logoImgUrl，和你需要的蛇形命名logo_img_url不匹配，等于你要的字段根本没走getter的计算逻辑
• 字符串拼接语法错误：getter里写的"http://localhost:30001/". this.logo_key用了点号而非模板字符串/加号，就算逻辑走到这里也会抛出语法错误
• 嵌套数组序列化时如果没有显式用@Type指定类型，class-transformer不会自动把数组里的普通对象递归转为Agency类实例，getter计算逻辑完全不会触发，只会读取初始化的空值
• 原代码硬编码端口为30001，和预期返回的3000端口不一致

1. 删掉冗余的logo_img_url实例属性，直接在getter方法上配置@Expose({ name: 'logo_img_url' })，getter是实时计算的，每次序列化都会取最新的logo_key值拼接
2. 修正字符串拼接的语法错误，加上空值判断避免logo_key为空时拼接出undefined
3. 嵌套数组场景给数组字段加@Type装饰器指定数组项类型，确保class-transformer能正确递归转换实例
4. 替换硬编码的地址逻辑，优先用项目内封装的工具方法生成图片地址，避免多环境端口/域名不一致问题

修正后的Agency实体代码：

import { Expose } from 'class-transformer';
import { Entity, Column } from 'typeorm';

import { BaseEntity } from '@common/base/entity.base';
import { getAdminImageUrl } from '@common/util/vault-file.util';

@Entity()
export class Agency extends BaseEntity {

  @Expose()
  @Column({
    type: 'varchar',
    length: '255',
    nullable: true,
  })
  public logo_key!: string;

  // 直接在getter上指定导出的字段名，不需要额外定义中间属性
  @Expose({ name: 'logo_img_url' })
  get logoImgUrl(): string {
    if (!this.logo_key) return '';
    // 生产环境直接用封装的工具方法即可，不需要硬编码地址
    // return getAdminImageUrl(this.logo_key);
    return `http://localhost:3000/${this.logo_key}`;
  }
}

如果Agency是作为列表接口返回的嵌套数组，需要在返回的响应DTO里给数组字段加@Type装饰器，确保class-transformer正确转换：

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

export class PaginationMeta {
  @Expose() status_code: number;
  @Expose() pagination: any;
}

export class AgencyListResponse {
  @Expose()
  @Type(() => Agency) // 关键配置：指定数组项类型，递归转换为Agency实例
  data: Agency[];

  @Expose()
  @Type(() => PaginationMeta)
  meta: PaginationMeta;
}

接口返回前统一用class-transformer的方法做序列化处理：

// 从数据库查询机构列表
const agencyList = await this.agencyRepository.find({ skip, take });
// 组装原始返回数据
const rawResp = {
  data: agencyList,
  meta: {
    status_code: 200,
    pagination: paginationData
  }
};
// 转换为符合序列化规则的普通对象返回
return instanceToPlain(plainToInstance(AgencyListResponse, rawResp));

改完后接口返回的logo_img_url字段会正确拼接域名和文件key，和你预期的响应结构完全一致，单个对象、嵌套数组场景都能正常生成字段值，不会再出现空值问题。

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