EF Core Code First：如何将枚举转为查找表并添加关联外键？

我来给你一步步拆解怎么在EF Core里把枚举转成可维护的查找表，同时建立正确的外键关联：

1. 定义枚举与查找实体 #

首先，咱们先有一个普通的枚举，比如：

public enum OrderStatus
{
    Pending = 1,
    Processing,
    Shipped,
    Delivered
}

然后创建对应的查找实体，用来存储枚举的键值对，方便后续维护：

public class OrderStatusLookup
{
    public int Id { get; set; } // 和枚举的数值类型一致
    public string Name { get; set; } // 枚举的名称，比如"Pending"
}

2. 修改主实体，添加外键与导航属性 #

假设你有个主实体Order，之前直接用OrderStatus枚举属性，现在改成用外键关联查找表：

public class Order
{
    public int Id { get; set; }
    // 外键字段，对应查找表的Id
    public int StatusId { get; set; }
    // 导航属性，关联到查找表
    public OrderStatusLookup Status { get; set; }
    // 其他属性...
}

如果你想保留枚举属性方便业务代码使用，可以加一个无映射的计算属性：

[NotMapped]
public OrderStatus StatusEnum => (OrderStatus)StatusId;

3. 在DbContext中配置关系 #

接下来在你的数据库上下文的OnModelCreating方法里，用Fluent API配置查找表和关联关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置查找表的主键
    modelBuilder.Entity<OrderStatusLookup>()
        .HasKey(s => s.Id);
    
    // 确保Name字段唯一，避免重复数据
    modelBuilder.Entity<OrderStatusLookup>()
        .HasIndex(s => s.Name)
        .IsUnique();
    
    // 配置Order和OrderStatusLookup的外键关系
    modelBuilder.Entity<Order>()
        .HasOne(o => o.Status)
        .WithMany() // 一个状态可以对应多个订单
        .HasForeignKey(o => o.StatusId)
        .OnDelete(DeleteBehavior.Restrict); // 根据业务需求设置删除行为
}

4. 添加查找表的种子数据 #

为了让数据库初始化时就有枚举对应的查找数据，咱们用EF Core的种子数据功能：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 上面的配置代码...
    
    // 插入枚举对应的查找数据
    modelBuilder.Entity<OrderStatusLookup>()
        .HasData(
            new OrderStatusLookup { Id = (int)OrderStatus.Pending, Name = nameof(OrderStatus.Pending) },
            new OrderStatusLookup { Id = (int)OrderStatus.Processing, Name = nameof(OrderStatus.Processing) },
            new OrderStatusLookup { Id = (int)OrderStatus.Shipped, Name = nameof(OrderStatus.Shipped) },
            new OrderStatusLookup { Id = (int)OrderStatus.Delivered, Name = nameof(OrderStatus.Delivered) }
        );
}

5. 生成迁移并更新数据库 #

最后，运行EF Core的迁移命令来创建查找表和外键约束：

# 生成迁移文件
dotnet ef migrations add AddOrderStatusLookupTable
# 更新数据库
dotnet ef database update

注意事项 #

• 如果你的项目之前已经用了枚举属性存储数据，迁移时需要先创建查找表并插入种子数据，然后写自定义迁移代码把原有枚举值映射到新的StatusId字段，再删除原来的枚举属性。
• 枚举的数值最好明确指定（比如Pending = 1），避免默认的0值或者后续新增枚举时数值混乱，导致种子数据和业务数据不匹配。

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