EF Core中如何为枚举属性添加至查找表的外键约束？

我有一个包含枚举属性的Model类，该属性在EF Core代码优先配置中定义了自定义枚举转字符串转换器。同时我为该枚举创建了对应的StatusLookup查找表类，已完成EF Core代码优先配置并生成了枚举变体的种子数据。

我希望Model类的枚举列能添加外键约束，关联到StatusLookup表的Code列——因为存在数据人员直接操作数据库的场景，该约束能明确有效值范围，避免输入无效枚举值。

以下是示例代码：

模型类 #

class Model
{
    public Status Status { get; private set; }
}

枚举 #

enum Status
{
    [Code("Active")]
    Active = 1,

    [Code("Pending")]
    Pending = 2,

    [Code("InProgress")]
    InProgress = 3,

    [Code("Complete")]
    Complete = 4
}

查找表类 #

class StatusLookup
{
    public required int Id { get; init; }
    public required string Code { get; init; }
}

查找表EF Core配置 #

public void Configure(EntityTypeBuilder<StatusLookup> builder)
{
    builder
        .ToTable($"Lookup_Status");

    builder
        .HasKey(t => t.Id);

    builder
        .Property(t => t.Code)
        .HasMaxLength(64)
        .IsRequired();

    // 种子数据填充
    builder
        .HasData(
            BuildLookupLists() // 通过反射构建查找列表数据
        );
}

模型配置（当前报错版本） #

protected override void ConfigureEntity(EntityTypeBuilder<Model> builder)
{
    builder
        .Property(t => t.Status)
        .HasConversion(
            s => s.GetCode(),
            c => EnumFromCode<Status>(c))
        .IsRequired();
    
    // 此代码无法运行，仅用于示意需求
    builder
        .HasOne<StatusLookup>()
        .WithMany()
        .HasForeignKey(t => t.Status)
        .HasPrincipalKey(t => t.Code)
        .OnDelete(DeleteBehavior.Restrict);
}

当前问题：EF Core提示无法映射Status枚举类型与Code字符串类型，请问该需求是否可行？

该需求完全可行，EF Core支持这种场景，但需要调整配置逻辑——直接用枚举属性作为外键会因为CLR类型与数据库列类型不匹配报错，需要明确告诉EF Core使用转换后的数据库列类型来建立外键约束。以下是两种可行方案：

方案一：使用阴影属性（无需修改Model类） #

通过定义阴影属性对应数据库中的字符串列，将枚举属性映射到该列，再用阴影属性作为外键关联查找表：

protected override void ConfigureEntity(EntityTypeBuilder<Model> builder)
{
    // 定义阴影属性，对应数据库存储枚举Code的字符串列
    builder.Property<string>("StatusCode")
           .HasMaxLength(64)
           .IsRequired();

    // 将枚举属性与阴影属性关联，实现枚举<->字符串的转换
    builder.Property(t => t.Status)
           .HasConversion(
               s => s.GetCode(),
               c => EnumFromCode<Status>(c))
           .HasColumnName("StatusCode") // 指定枚举属性映射到阴影属性对应的列
           .IsRequired();

    // 配置外键约束，使用阴影属性关联到StatusLookup的Code列
    builder.HasOne<StatusLookup>()
           .WithMany()
           .HasForeignKey("StatusCode")
           .HasPrincipalKey(s => s.Code)
           .OnDelete(DeleteBehavior.Restrict);
}

说明：阴影属性StatusCode仅存在于EF Core的模型元数据中，不会出现在Model类的CLR定义里，但会在数据库中生成对应的字符串列，同时建立外键约束。

方案二：显式添加字符串属性（允许修改Model类） #

如果可以修改Model类，直接添加一个字符串属性存储枚举的Code，以此作为外键关联查找表：

修改后的Model类 #

class Model
{
    public Status Status { get; private set; }
    public string StatusCode { get; private set; } // 新增属性，对应数据库列
}

对应的模型配置 #

protected override void ConfigureEntity(EntityTypeBuilder<Model> builder)
{
    // 配置StatusCode属性的数据库特性
    builder.Property(t => t.StatusCode)
           .HasMaxLength(64)
           .IsRequired();

    // 将枚举属性映射到StatusCode列，避免重复存储
    builder.Property(t => t.Status)
           .HasConversion(
               s => s.GetCode(),
               c => EnumFromCode<Status>(c))
           .HasColumnName("StatusCode")
           .IsRequired()
           .Metadata.SetAfterSaveBehavior(PropertySaveBehavior.Ignore); // 避免EF Core重复处理该属性

    // 配置外键约束
    builder.HasOne<StatusLookup>()
           .WithMany()
           .HasForeignKey(t => t.StatusCode)
           .HasPrincipalKey(s => s.Code)
           .OnDelete(DeleteBehavior.Restrict);
}

说明：这种方式更直观，显式的字符串属性作为外键载体，枚举属性通过转换器与该属性共享同一数据库列，SetAfterSaveBehavior用于避免EF Core在保存时尝试更新枚举属性（因为值已通过StatusCode同步）。

两种方案最终都会在数据库中为Model表的StatusCode列创建外键约束，关联到Lookup_Status表的Code列，从而限制只能输入查找表中存在的有效值。

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