EF Core 3.1迁移至6.0时影子属性相关列名错误求助

核心问题分析 #

1. 保留实体属性与影子属性时，两者映射到同一数据库列BNK_REF_NBR，违反EF Core的唯一列映射规则
2. 移除影子属性后，EF仍自动推断生成PaymentTransactionReferenceNumber影子外键，导致查询时提示列不存在
3. OnModelCreating阶段自动创建影子外键索引，源于EF的关系约定推断

解决方案一：彻底清理影子属性，使用实体类现有属性 #

如果不需要保留原影子属性，按以下步骤处理：

1. 清理遗留配置 #

• 检查OnModelCreating中所有针对PaymentTransactionReferenceNumber的影子属性配置，彻底删除类似代码：

  // 删除这类配置
  entity.Property<string>("PaymentTransactionReferenceNumber")
        .HasColumnName("BNK_REF_NBR");
  

• 检查模型类及关联实体的数据注解，删除任何指向PaymentTransactionReferenceNumber的[ForeignKey]、[Related]等注解

2. 显式配置关联关系，阻止EF自动生成影子外键 #

由于ClaimAmountTransaction包含Payment导航属性，EF会自动推断外键。需显式指定用现有实体属性BnkRefNbr作为外键：

// 在OnModelCreating中配置ClaimAmountTransaction与Payment的关联
entity.HasOne(e => e.Payment)
      .WithMany() // 根据实际业务关系调整，比如Payment包含多个ClaimAmountTransaction则写.WithMany(p => p.ClaimAmountTransactions)
      .HasForeignKey(e => e.BnkRefNbr) // 指定实体类的BnkRefNbr作为外键
      .HasPrincipalKey(p => p.YourPaymentReferenceField); // 替换为Payment实体中对应BNK_REF_NBR的字段名

3. 验证查询代码 #

当前提供的仓储代码中使用的是e.BnkRefNbr，符合要求，无需修改

解决方案二：在EF Core 6.0中正确创建影子属性 #

如果需要保留原影子属性（替代实体类的PaymentTrnsRefNbr），按以下步骤操作：

1. 删除实体类中的冲突属性 #

从ClaimAmountTransaction模型中移除PaymentTrnsRefNbr属性：

// 移除该行
public string? PaymentTrnsRefNbr { get; set; }

2. 正确配置影子属性 #

在OnModelCreating中添加影子属性的配置，确保映射到正确列：

entity.Property<string>("PaymentTransactionReferenceNumber")
      .HasMaxLength(16)
      .HasColumnName("BNK_REF_NBR");

3. 关联关系绑定到影子属性 #

如果Payment导航属性需要使用该影子属性作为外键，显式配置：

entity.HasOne(e => e.Payment)
      .WithMany()
      .HasForeignKey("PaymentTransactionReferenceNumber") // 使用影子属性作为外键
      .HasPrincipalKey(p => p.YourPaymentReferenceField);

额外注意事项 #

• 执行迁移前，务必清理所有旧的迁移文件，重新生成新的迁移脚本，避免残留的影子属性配置影响数据库结构
• 检查EF Core的日志输出，查看OnModelCreating阶段的实体配置详情，确认没有自动生成的影子属性

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