EF Core shadow properties 变更检测异常：CurrentValue、OriginalValue为null

• 概念混淆导致映射逻辑错位
  你当前代码中调用builder.Property("_name")映射的对象是实体类内部已定义的私有字段_name，但因为没有显式声明该属性对应的后备字段，EF Core会将其识别为一个独立的Shadow Property——这类属性不存在于CLR实体类的成员中，EF既不会自动和现有私有字段打通读写，也不会在变更跟踪阶段自动为其初始化存储值，最终导致读取CurrentValue和OriginalValue时返回null。
• 遍历变更跟踪条目的逻辑存在遗漏
  你仅遍历了主实体的顶层Properties集合，没有对Owned类型的嵌套实体做递归属性遍历，嵌套实体的属性变更不会被主实体的属性集合收录，进一步放大了取值异常的问题。
• 配置中builder.HasPartitionKey(x => x.PartitionKey)引用的属性未在实体类中定义，EF自动生成的对应Shadow Property如果没有在实体进入跟踪阶段被赋值，也会出现取值为null的情况。

映射私有跟踪字段时，使用显式后备字段绑定而非Shadow Property #

如果目标是将类内部的私有字段纳入变更跟踪、又不希望将其暴露为公开类成员，完全不需要依赖Shadow Property机制，直接在实体配置中显式声明后备字段的绑定关系即可：

// 替换原有对 "_name" 的简单字符串映射
builder.Property<string>("_name")
    .HasField("_name") // 显式指定属性对应的类内私有字段
    .UsePropertyAccessMode(PropertyAccessMode.Field) // 要求EF优先通过字段访问读写值
    .ToJsonProperty("name");

这种方式实现的属性属于EF常规跟踪属性，会自动在变更跟踪器中维护正确的原始值和当前值，读取时不会出现null异常。

若确实需要使用无类成员的Shadow Property，需补齐初始化与遍历逻辑 #

• 所有自定义Shadow Property必须在实体进入变更跟踪时显式赋值，不能依赖EF自动初始化，可在SaveChanges拦截逻辑或者实体状态变更逻辑中统一写入初始值
• 遍历变更跟踪内容时，需要递归处理所有导航属性下的嵌套实体条目，不能仅遍历主实体顶层属性：

var trackedEntries = _context.ChangeTracker.Entries().ToArray();
foreach (var entry in trackedEntries)
{
    // 处理当前实体的所有属性变更
    foreach (var property in entry.Properties)
    {
        // 执行变更记录逻辑
    }
    // 遍历导航关联的嵌套实体条目
    foreach (var navigation in entry.Navigations)
    {
        var nestedEntry = navigation.Entry;
        // 处理嵌套实体的所有属性变更
        foreach (var nestedProperty in nestedEntry.Properties)
        {
            // 执行嵌套属性的变更记录逻辑
        }
    }
}

Shadow Property的成熟替代方案 #

如果你的核心需求是把非公开的跟踪类属性和实体代码解耦，除了Shadow Property，还有两种稳定性更高的实现路径：

• 私有字段+后备字段映射：即上述的修正方案，需要跟踪的非公开属性直接定义为类内私有字段，通过EF的后备字段映射纳入跟踪，对外部调用方保持不可见，同时变更跟踪逻辑完全符合EF的常规行为
• 独立审计对象+Owned类型映射：把所有需要跟踪的属性抽到一个独立的小类中，通过主实体的OwnsOne映射嵌入主实体的存储结构，所有跟踪属性直接定义为类内公开成员，不需要复杂的字段绑定逻辑，也能获得完整的变更跟踪能力

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