添加[NotMapped]的DisplayStatus属性仍在EF Core迁移中生成列及外键

问题详情 #

• 主模型原本包含Status属性，同时拥有Import值对象（其下多属性映射至对应表列）
• 将Status移入Import值对象后，主模型新增带[NotMapped]特性的DisplayStatus属性——该属性为数据库枚举ImportStatus类型，手动根据Import内的状态及其他值设置
• 生成迁移时，DisplayStatus仍被创建表列，且生成指向ImportStatus表的外键
• 已尝试在DbContext的OnModelCreating方法中添加配置b.Ignore(b => b.DisplayStatus);，问题依旧
• 项目刚从.NET 5.0升级至.NET 6.0，EF Core从5.0.0升级至7.0.5，此为升级后首次迁移；新建项目无该问题

解决方案 #

1. 排查枚举的实体化配置 #

EF Core 7对数据库枚举的处理逻辑有调整，确认ImportStatus是否被误配置为实体：

• 检查DbContext中是否存在DbSet<ImportStatus>定义
• 查看OnModelCreating中是否有modelBuilder.Entity<ImportStatus>()的配置
  若存在以上配置，EF会将ImportStatus视为实体表，导致DisplayStatus被识别为外键关联属性，需删除这类错误配置。

2. 清理迁移缓存与残留文件 #

升级后的首次迁移可能残留旧版本的配置缓存：

• 删除项目中已有的迁移文件（注意备份最新的模型快照文件）
• 清理项目的bin和obj目录，重新生成解决方案
• 重新执行Add-Migration命令生成新迁移

3. 确认值对象的映射配置 #

确保EF Core正确识别Import为值对象（Owned Entity）：

modelBuilder.Entity<YourMainModel>().OwnsOne(x => x.Import);

若值对象映射配置缺失或错误，可能导致EF对主模型属性的识别逻辑异常。

4. 显式配置枚举转换 #

在OnModelCreating中明确配置Import内Status枚举的转换规则，避免枚举被误识别：

modelBuilder.Entity<YourMainModel>()
    .OwnsOne(x => x.Import)
    .Property(x => x.Status)
    .HasConversion<string>(); // 或根据数据库类型选择合适的转换方式，如HasConversion<int>()

5. 检查全局配置干扰 #

查看DbContext中的全局配置，确认没有意外覆盖[NotMapped]或Ignore规则：

• 排查是否存在类似modelBuilder.Properties().Configure(...)的全局属性配置，这类配置可能强制所有属性参与映射。

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