NestJS TypeORM子实体parent_description字段值异常匹配父实体description

实体定义 #

Parent实体：

@Entity()
export class Parent{
  @PrimaryGeneratedColumn('uuid')
  id: string;

  @Column()
  description: string;

  @OneToMany(() => Child, (child) => child.parent, {
    cascade: true,
  })
  children: Child[];
}

Child实体：

@Entity()
export class Child {
  @PrimaryGeneratedColumn('uuid')
  id: string;

  @Column()
  parent_description: string;

  @ManyToOne(() => Parent, (parent) => parent.children, { eager: true })
  parent: Parent;
}

parent_description字段用于存储每个子实体独有的父级描述，无法放在Parent实体中。

问题现象 #

• 查询Parent实体时，子实体的parent_description值正确：

Parent {
  id: 'cdf8d726-6c86-4dfc-85b9-ebb7bae68d68',
  description: 'Parent description',
  children: [
    Child {
      id: '0da2b990-297b-4d30-a255-86a7e5ba632a',
      parent_description: 'Child description',
    },
  ]
}

• 直接查询Child实体时，parent_description的值却与Parent的description字段值一致：

Child{
    id: '9362ae33-9212-4d69-91f1-021dca826243',
    parent_description: 'Parent description',
  }

服务代码 #

@Injectable()
export class ChildService {
  constructor(
    @InjectRepository(Child)
    private childRepository: Repository<Child>,
    @InjectRepository(Parent)
    private parentsRepository: Repository<Parent>,
  ) {}

  findOne(id: string): Promise<Child> {
    return this.childRepository.findOne({
      where: { id: id },
    });
  }
  findParent(id: string): Promise<Parent> {
    return this.parentsRepository.findOne({
      relations: ['children'],
      where: { id: id },
    });
  }
}

请问这是TypeORM的预期行为吗？是否可以禁用该行为？

这不是TypeORM的预期行为，问题根源是字段命名引发的SQL查询别名冲突：

你给Child实体的parent关联设置了eager: true，当TypeORM自动执行关联查询时，会给Parent实体的description字段生成别名parent_description（规则为关联属性名_字段名），这和Child实体自身的parent_description字段的数据库列名完全一致。数据库返回结果时，后出现的字段值会覆盖前一个，最终导致Child的parent_description被Parent的description值替换。

可以通过以下几种方式解决：

方案1：修改Child字段的数据库列名 #

给parent_description指定一个不会和关联实体字段别名冲突的列名，从根源避免冲突：

@Column({ name: 'child_parent_desc' }) // 自定义列名，避免与关联字段别名重复
parent_description: string;

方案2：关闭eager加载，改用手动关联查询 #

移除@ManyToOne中的eager: true，然后在查询Child时手动加载Parent，同时通过明确指定字段确保映射正确：

// 修改Child实体的关联定义
@ManyToOne(() => Parent, (parent) => parent.children) // 去掉eager: true
parent: Parent;

// 修改ChildService的findOne方法
findOne(id: string): Promise<Child> {
  return this.childRepository.findOne({
    where: { id },
    relations: ['parent'],
  });
}

如果需要更精确控制查询逻辑，建议使用QueryBuilder：

findOne(id: string): Promise<Child> {
  return this.childRepository
    .createQueryBuilder('child')
    .select(['child.id', 'child.parent_description', 'parent.id', 'parent.description'])
    .leftJoin('child.parent', 'parent')
    .where('child.id = :id', { id })
    .getOne();
}

方案3：修改Parent实体字段名（可选） #

如果业务允许，可以修改Parent的description字段名为其他名称，避免生成冲突的别名，但此方案影响范围较大，不推荐优先使用。

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