为什么TypeORM的loadEagerRelations选项存在不符合预期的行为?
问题定性
该现象不属于TypeORM的设计预期,属于当前版本的实现逻辑缺陷。
缺陷的产生逻辑
定位到的关联收集逻辑存在配置传递遗漏:
- 顶层实体的eager关联加载判断,是正确接入
loadEagerRelations配置校验的,因此设置loadEagerRelations: false后,Father实体自身定义的eager关联会被正常屏蔽,这部分行为符合设计预期 - 当流程走到加载用户通过
relations参数显式指定的关联(即示例中的son)时,递归收集Son实体关联关系的分支没有接入loadEagerRelations的配置判断,会无差别全量加载Son实体上定义的所有eager关联 - 这种配置断层会在多层层级关联的场景下被放大:递归遍历的每一层实体都不会读取全局的
loadEagerRelations配置,最终会生成包含大量冗余join的长SQL,直接造成查询性能异常下降
临时规避方案
在官方修复发布前,可以通过调整relations参数的写法规避该问题:
把字符串数组形式的关联声明,替换为对象形式的显式嵌套声明。TypeORM在解析对象形式的relations配置时,只会加载手动列出的嵌套关联,不会自动触发未声明层级的递归eager加载。对应示例代码调整为:
const father: Father = await this.fatherRepo.findOne({ where: { id }, relations: { // 只声明需要加载的关联层级,不展开son下的任何关联 son: {} }, loadEagerRelations: false });
注意:不要同时混用字符串数组和对象形式的
relations写法,否则仍会触发旧的递归收集逻辑,无法达到规避效果。
内容的提问来源于stack exchange,提问作者Sceriffo
相关产品推荐
相关产品推荐

