TypeORM的orphanedRowAction配置SQL变化及迁移模式失效问题

你使用的配置示例 #

@ChildEntity('business')
export default class BusinessGeolocation extends Geolocation {
  @ManyToOne(
    type => Business, business => business.geolocations, {
      onDelete: 'CASCADE',
      orphanedRowAction: "delete" // NEW
    })
  business!: Business;
}

orphanedRowAction: "delete" 对SQL生成逻辑的影响 #

这个配置是TypeORM在应用层实现的孤儿行清理规则，开启后会对SQL生成产生以下变化：

• 当你解除父子实体的关联关系时（比如从Business的geolocations数组中移除某个BusinessGeolocation实例，或是直接将BusinessGeolocation实例的business属性设为null），TypeORM不会像默认逻辑那样生成UPDATE geolocation SET businessId = null WHERE id = ?的语句，而是直接生成DELETE FROM geolocation WHERE id = ?的语句删除对应的子表记录。
• 该逻辑和数据库层面的onDelete: 'CASCADE'是互补关系：onDelete: 'CASCADE'仅在父表记录被删除时触发子表关联记录删除，orphanedRowAction: 'delete'则是在关联关系解除、但父表记录本身没有被删除的场景下触发子表记录删除。

迁移模式下触发外键报错的原因 #

你遇到的synchronize: true正常、migrations: true模式报错是TypeORM 0.2.30版本的已知缺陷：

• synchronize: true模式下TypeORM会直接读取实体装饰器的运行时配置，执行删除操作时会先触发孤儿行清理逻辑，按照先删子表孤立行、再操作父表的顺序生成SQL，不会触发外键约束。
• 0.2.30版本的迁移生成工具不会将orphanedRowAction的规则纳入迁移逻辑，运行迁移时也不会主动识别该配置触发对应的孤儿行删除逻辑，你删除父表记录时子表仍然存在关联的外键记录，就会抛出如下错误：

Error: Run: error code 19: FOREIGN KEY constraint failed
query failed:  DELETE FROM "forms" WHERE "formId" = ? -- PARAMETERS: [1]

修复方案 #

可以升级到TypeORM 0.2.37及以上版本，该版本已经修复了迁移模式下orphanedRowAction不生效的问题。如果暂时不能升级，需要在业务代码中手动补充关联子记录的删除逻辑，避免出现孤立子记录触发外键约束。

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