EF Core 8+PostgreSQL中TPC层级映射触发InvalidCastException求助

核心原因 #

TPC（Table-Per-Concrete-Type）模式下，每个具体实体对应独立数据表，若不同表的主键值存在重复，EF Core执行关联查询时会错误地将某一实体的记录识别为另一类型，进而抛出类型转换异常（比如把ArrangementSong实例强制转换为Circle）。

具体解决步骤 #

1. 排查并修正现有主键重复数据

   • 直接查询所有TPC模式下的实体表（如Circle、ArrangementSong），检查主键列（如Id）是否存在重叠值。
   • 若存在重复，批量调整其中一类实体的主键值，比如：

     UPDATE ArrangementSong SET Id = Id + 10000;
     

     偏移量根据实际数据量调整，确保两类实体主键完全不重叠。

2. 配置独立主键生成策略，杜绝后续重复

   • 针对不同具体实体，设置不重叠的主键自增起始值：

     // Circle实体配置
     builder.Property(c => c.Id).UseIdentityColumn(1, 1);
     // ArrangementSong实体配置
     builder.Property(s => s.Id).UseIdentityColumn(10000, 1);
     

   • 也可以改用GUID作为主键，从根源避免重复：

     builder.Property(c => c.Id).HasDefaultValueSql("NEWID()");
     

3. 校验TPC映射与关联配置

   • 确认所有继承自BaseAuditedEntity的实体都正确启用TPC策略：

     modelBuilder.Entity<TierListItem>().UseTpcMappingStrategy();
     // 其他继承实体也需同步配置
     

   • 检查TierListItem与Circle的关联配置，确保没有错误指向其他实体类型。

4. 重置迁移（若生成策略有误）

   • 如果之前的迁移导致主键规则异常，可删除现有迁移文件后重新生成：

     Remove-Migration
     Add-Migration TPC_Fix_PrimaryKey
     Update-Database
     

额外排查手段 #

• 查看EF Core生成的SQL语句，确认关联逻辑是否正确：

  var query = context.TierListItems.Include(a => a.Circle);
  Console.WriteLine(query.ToQueryString());
  

• 检查实体继承链，确保ArrangementSong等实体没有误继承Circle类。

内容的提问来源于stack exchange，提问作者N.T. Dang