EF Core附加已存在实体时偶发InvalidOperationException问题排查

实体类定义 #

internal class ServicePackage {

    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int Id { get; set; }

    [Required]
    [ForeignKey("ServiceId")]
    [DeleteBehavior(DeleteBehavior.ClientNoAction)]
    public virtual Service Service { get; set; }

    public decimal Cost { get; set; }
}

DbContext配置 #

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) {
    optionsBuilder.UseSqlServer(SqlConnectionString);
    optionsBuilder.UseLazyLoadingProxies();
    base.OnConfiguring(optionsBuilder);
}

使用环境 #

• .NET 8.0
• Microsoft.EntityFrameworkCore.SqlServer 8.0.8

异常情况 #

极少情况下，调用dbContext.ServicePackages.Attach附加已存入数据库的ServicePackage实例时，会抛出System.InvalidOperationException异常，异常信息如下：

The navigation 'ServicePackage.Service' cannot be loaded because one or more of the key or foreign key properties are shadow properties and the entity is not being tracked. Relationships using shadow values can only be loaded for tracked entities.

Stack Trace:
Microsoft.EntityFrameworkCore.Internal.EntityFinder'1.GetLoadValues(INavigation, InternalEntityEntry)
← Microsoft.EntityFrameworkCore.Internal.EntityFinder'1.Load(INavigation, InternalEntityEntry, LoadOptions)
← Microsoft.EntityFrameworkCore.ChangeTracking.ReferenceEntry.Load(LoadOptions)
← Microsoft.EntityFrameworkCore.Infrastructure.Internal.LazyLoader.Load(Object, String)
← Castle.DynamicProxy.AbstractInvocation.Proceed()
← Castle.Proxies.ServicePackageProxy.get_Service()

核心成因 #

1. 影子外键未正确初始化：ServicePackage类仅定义了导航属性Service，未显式声明对应外键属性ServiceId，EF Core会自动创建影子属性ServiceId维护关联关系。调用Attach附加实例时，若该影子属性值未被正确设置，EF Core无法识别实体与Service的关联。
2. 延迟加载触发时机冲突：因启用了UseLazyLoadingProxies()，ServicePackage实例被附加后，若代码立即访问Service导航属性，延迟加载会触发。但此时EF Core若未完成影子外键的跟踪初始化，就会抛出异常——影子属性依赖实体被完整跟踪才能加载关联数据。

间歇性出现的原因 #

问题并非必现，取决于以下时机因素：

• Attach后的跟踪状态同步延迟：EF Core附加实体时需完成影子属性初始化、跟踪状态设置等操作。若这些操作未完成前，代码（比如多线程场景下其他线程）触发Service属性的延迟加载，就会抛出异常。
• 实体实例来源差异：若附加的ServicePackage实例来自缓存、第三方序列化或手动创建，可能存在影子属性未正确赋值的情况。仅当实例的ServiceId影子属性缺失或未被EF Core识别时才会报错；若实例曾被上下文跟踪过、影子属性已初始化，则不会触发异常。
• EF Core内部状态管理竞态条件：高并发场景下，上下文跟踪状态管理可能出现短暂不一致，导致影子属性加载时机与延迟加载触发时机冲突，从而间歇性抛出异常。

解决建议 #

• 显式声明外键属性：在ServicePackage类中添加public int ServiceId { get; set; }，替代EF Core自动生成的影子属性，让实体附加时外键值明确，不依赖影子属性初始化时机。
• 控制延迟加载触发时机：调用Attach后，先通过dbContext.Entry(servicePackage).Reload()或手动设置ServiceId，再访问Service导航属性；或在不需要延迟加载的场景下临时禁用延迟加载。
• 避免多线程共享DbContext：DbContext本身非线程安全，多线程同时操作同一上下文实例会导致跟踪状态混乱，这也是间歇性问题的常见诱因。

内容的提问来源于stack exchange，提问作者D .Stark