EF Core TPT映射报错：无匹配鉴别值无法物化Resource实体

报错信息 #

EF Core运行时抛出异常：

Unable to materialize entity instance of type 'Resource'. No discriminators matched the discriminator value ''.

注：同类型IdentityUser鉴别值不匹配的公开帖子方案不适用于本场景，无法解决故障。

异常堆栈 #

- at Microsoft.EntityFrameworkCore.Query.RelationalShapedQueryCompilingExpressionVisitor.ShaperProcessingExpressionVisitor.<PopulateIncludeCollection>g__ProcessCurrentElementRow|60_0[TIncludingEntity,TIncludedEntity](<>c__DisplayClass60_0`2& )
 - at Microsoft.EntityFrameworkCore.Query.RelationalShapedQueryCompilingExpressionVisitor.ShaperProcessingExpressionVisitor.PopulateIncludeCollection[TIncludingEntity,TIncludedEntity](Int32 collectionId, QueryContext queryContext, DbDataReader dbDataReader, SingleQueryResultCoordinator resultCoordinator, Func`3 parentIdentifier, Func`3 outerIdentifier, Func`3 selfIdentifier, IReadOnlyList`1 parentIdentifierValueComparers, IReadOnlyList`1 outerIdentifierValueComparers, IReadOnlyList`1 selfIdentifierValueComparers, Func`5 innerShaper, INavigationBase inverseNavigation, Action`2 fixup, Boolean trackingQuery)
 - at Microsoft.EntityFrameworkCore.Query.Internal.SingleQueryingEnumerable`1.Enumerator.MoveNext()
at General.Collection.ListExtension.AddRange[T](IList`1 source, IEnumerable`1 newList) in C:\prj\IreqNew\MicroReseau\General\Collection\ListExtension.cs:line 222

Exception TargetSite:
+        TargetSite    {Void <PopulateIncludeCollection>g__ProcessCurrentElementRow|60_0[TIncludingEntity,TIncludedEntity](<>c__DisplayClass60_0`2 ByRef)}    System.Reflection.MethodBase {System.Reflection.RuntimeMethodInfo}

场景说明 #

• 项目采用**Table per type (TPT，每个类型对应独立表)**继承映射策略，未使用EF Core官方默认推荐的TPH（层级共表）策略，因层级关联数据量较小，无需考虑TPT的性能影响
• 此前执行数据保存操作时曾触发表缺失异常，执行Add-Migration、Update-Database命令后异常仍未解决，查询关联数据时抛出上述错误

触发原因 #

该异常本质是EF Core在查询映射继承层级实体时，无法根据读取到的数据判定当前Resource基类记录对应的具体子实体类型，常见触发场景：

• 迁移执行不完整：TPT映射要求的子类表未全部生成，或基表与子表的外键关联关系配置错误
• 脏数据残留：基表Resources中存在没有对应子表关联记录的无效数据，EF Core关联子表查询时取不到匹配的子类型标识，返回空鉴别值
• 映射配置错误：代码中残留TPH模式下的HasDiscriminator()配置，TPT模式本身不需要手动配置鉴别器，错误配置会导致EF Core按TPH的鉴别器逻辑匹配类型，读到空值直接抛错
• 策略切换遗留问题：如果是从TPH策略切换到TPT策略，未清理旧表遗留的鉴别器字段，也未补全基表与子表的关联数据，会出现匹配失败问题

修复方案 #

1. 校验表结构完整性
   检查所有继承自Resource的子类对应的独立表是否全部创建完成，确认子类表主键同时为关联基表主键的外键。如果存在表缺失、外键关系错误的问题，删除现有错误的迁移文件，重新执行迁移生成与应用命令：

   Add-Migration Fix_TPT_Mapping
   Update-Database
   

2. 清理无效脏数据
   执行SQL语句查询基表中无对应子表关联的无效记录，根据业务需求删除或补全对应子表的关联数据：

   -- 替换为实际业务的表名、主键字段名，所有子类表都需要添加LEFT JOIN关联
   SELECT r.* FROM Resources r
   LEFT JOIN PhysicalResources pr ON r.Id = pr.Id
   LEFT JOIN VirtualResources vr ON r.Id = vr.Id
   WHERE pr.Id IS NULL AND vr.Id IS NULL
   

3. 修正实体映射配置
   检查DbContext中的实体映射代码，删除TPT模式下不需要的鉴别器配置，标准TPT映射示例如下：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       // 基类映射到基表
       modelBuilder.Entity<Resource>().ToTable("Resources");
       // 所有子类各自映射到独立表，无需配置HasDiscriminator
       modelBuilder.Entity<PhysicalResource>().ToTable("PhysicalResources");
       modelBuilder.Entity<VirtualResource>().ToTable("VirtualResources");
   }
   

4. 修复完成后重新执行带Include的关联查询，确认异常消失。

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