TypeORM关联查询方案抉择：单查询带关联VS分查询传参数

背景 #

先给出TypeORM实体定义：

@Entity()    
export class Kid {
    @PrimaryGeneratedColumn()
    id: number;
        
    @Column()
    name: string;
      
    @OneToMany(() => Pet, pet => pet.kid)
    pets: Pet[];
}
    
@Entity()
export class Pet {
    @PrimaryGeneratedColumn()
    id: number;
        
    @Column()
    name: string;
        
    @ManyToOne(() => Kid, kid => kid.pets)
    kid: Kid;
}

针对SerializeKid函数，目前有两种实现和调用方案，以下是详细对比：

方案一：单参数关联查询 #

函数定义 #

SerializeKid(kid: Kid) {}

调用方式 #

const kid = await kidsRepo.find({where: {publicId: 1}, relations: ['pets']});
const result = SerializeKid(kid);

提问者倾向此方案，认为分查询传参不够优雅，计划在函数内增加合法性校验。

方案二：分参数显式传参 #

函数定义 #

SerializeKid(kid: Kid, pets: Pet[]) {}

调用方式 #

const kid = await kidsRepo.find({where: {publicId: 1}});
const pets = await petsRepo.find({where: {kid: kid.id}});
const result = SerializeKid(kid, pets);

支持此方案的理由：

• 避免其他调用者未预先查询关联关系，传入无pets的Kid对象引发混淆
• 明确提示调用者需显式查询关联关系，无需时可节省数据库查询时间
• 关注点分离：数据查询与序列化逻辑解耦
• 单关联查询可能耗时久，分查询可在多数据库实例间分摊负载

方案优劣分析与选择 #

两种方案各有适用场景，没有绝对的最优解，需结合业务需求和团队规范判断：

方案一的核心优势 #

1. 代码简洁直观：调用方只需一次查询，传参逻辑符合对象关联的自然认知，无需额外拆分查询步骤
2. ORM优化适配：TypeORM的关联查询会生成高效的JOIN语句，在单数据库实例下，一次JOIN的性能通常优于两次独立查询
3. 减少重复代码：无需在每个调用处重复编写pets的查询逻辑，降低维护成本

方案一的潜在风险 #

1. 隐式依赖易出错：若调用者遗漏relations: ['pets']参数，会导致kid.pets为空或undefined，必须在SerializeKid内增加校验逻辑（如抛出明确错误），否则可能引发序列化异常
2. 强制查询冗余：即使某些场景不需要pets数据，也会被强制查询，造成不必要的数据库开销

方案二的核心优势 #

1. 依赖显式更可靠：函数签名明确要求传入pets，调用者无法忽略关联数据的查询，从根源上避免隐式错误
2. 灵活性拉满：可根据业务需求选择是否查询pets，甚至可以对pets做自定义过滤后再传入，适配更多场景
3. 职责边界清晰：查询逻辑与序列化逻辑完全解耦，序列化函数只需专注于数据格式转换，无需关心数据来源
4. 分布式场景适配：在多数据库实例部署的架构下，分查询可以分散到不同实例，避免单JOIN查询占用过多资源

方案二的潜在问题 #

1. 代码冗余繁琐：每个调用处都需要单独编写pets的查询逻辑，增加重复代码量
2. 性能损耗：两次独立查询会增加数据库连接开销，在单实例场景下性能不如一次JOIN；若处理批量Kid数据时未做优化，还会出现N+1查询问题

折中优化建议 #

如果想兼顾优雅性和可靠性，可以考虑以下方案：

1. 保留单参数签名+严格校验：维持方案一的函数形式，但在内部严格校验kid.pets是否存在，若缺失则抛出明确错误，并在函数注释中清晰说明需要预先查询关联关系
2. 封装查询逻辑：在Repository层封装findKidWithPets方法，统一处理关联查询，避免调用者手动编写relations参数，减少出错概率
3. 提供函数重载：同时支持两种调用方式，既允许传入完整的Kid对象，也允许分开传入kid和pets，兼顾灵活性和代码优雅性

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