NestJS 10 + MikroORM 6.3中findOne无法填充嵌套关联问题

1. 确认实体关联定义正确性 #

先确保三层实体的关联装饰器配置符合一对多/多对一的映射规则，示例如下：

// CertificateEntity.ts
@Entity()
export class CertificateEntity {
  @PrimaryKey()
  id: number;

  @Property()
  type: string;

  @OneToMany(() => CertificateModuleEntity, module => module.certificate)
  modules: CertificateModuleEntity[];
}

// CertificateModuleEntity.ts
@Entity()
export class CertificateModuleEntity {
  @PrimaryKey()
  id: number;

  @ManyToOne(() => CertificateEntity)
  certificate: CertificateEntity;

  @OneToMany(() => CertificateQuestionEntity, question => question.module)
  questions: CertificateQuestionEntity[];
}

// CertificateQuestionEntity.ts
@Entity()
export class CertificateQuestionEntity {
  @PrimaryKey()
  id: number;

  @ManyToOne(() => CertificateModuleEntity)
  module: CertificateModuleEntity;

  @Property()
  content: string;
}

注意：不要随意开启eager: true，避免全局自动加载引发性能问题，保持按需加载的控制。

2. 显式配置嵌套关联的populate参数 #

MikroORM 6.x不会自动递归加载嵌套关联，必须在查询时明确指定层级：

async getCertificateByType(type: string) {
  return await this.certificateRepository.findOne(
    { type },
    {
      populate: ['modules', 'modules.questions'] // 明确声明需要加载的嵌套关联
    }
  );
}

如果使用QueryBuilder，写法如下：

async getCertificateByType(type: string) {
  return await this.certificateRepository.createQueryBuilder('cert')
    .leftJoinAndSelect('cert.modules', 'module')
    .leftJoinAndSelect('module.questions', 'question')
    .where('cert.type = :type', { type })
    .getSingleResult();
}

3. 检查响应序列化配置 #

如果使用NestJS的class-transformer返回响应，要确保关联属性添加@Expose()装饰器，否则序列化时会被忽略：

// CertificateEntity.ts
import { Expose } from 'class-transformer';

@Entity()
export class CertificateEntity {
  // ...其他属性

  @Expose()
  @OneToMany(() => CertificateModuleEntity, module => module.certificate)
  modules: CertificateModuleEntity[];
}

// CertificateModuleEntity.ts
@Entity()
export class CertificateModuleEntity {
  // ...其他属性

  @Expose()
  @OneToMany(() => CertificateQuestionEntity, question => question.module)
  questions: CertificateQuestionEntity[];
}

4. 排查延迟加载问题 #

若未配置populate，MikroORM默认不会自动加载关联。虽然开启延迟加载（默认useProxy: true）可以通过访问属性触发加载，但会引发N+1查询问题，更推荐显式populate的方式。

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