EF Core中HasConversion<string>()存储枚举值而非名称的问题排查

核心原因 #

你遇到的问题本质是EF Core默认的枚举转字符串逻辑是把枚举的数值转成字符串，而非枚举名称，同时查询报错是因为数据库列实际存储的是字符串，但EF尝试按整数规则解析，或列类型与配置不匹配。

正确配置方式 #

要让枚举存储为名称字符串，需要明确指定双向转换逻辑，而非仅调用HasConversion<string>()，以下是两种可行方案：

方案1：显式使用内置EnumToStringConverter #

之前尝试该方法未生效，大概率是未正确指定泛型参数。正确写法：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Entity>()
        .Property(e => e.Type)
        .HasConversion(new EnumToStringConverter<EntityTypes>())
        .HasMaxLength(50); // 根据枚举名称实际长度调整
}

方案2：自定义委托转换 #

手动定义枚举与字符串的双向转换规则：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Entity>()
        .Property(e => e.Type)
        .HasConversion(
            enumValue => enumValue.ToString(), // 枚举转名称字符串（存入数据库）
            stringValue => (EntityTypes)Enum.Parse(typeof(EntityTypes), stringValue) // 字符串转枚举（查询解析）
        )
        .HasMaxLength(50);
}

必须执行的关键步骤 #

1. 更新数据库列类型
   若之前已生成迁移或创建表，Type列的类型可能仍是int或存储数字字符串的varchar。需确保列类型为字符串类型（如SQL Server的varchar），并通过迁移更新数据库：

   Add-Migration UpdateEntityTypeToStringColumn
   Update-Database
   

2. 清理旧数据
   表中已存储的数字字符串（如'0'、'1'）会导致查询转换错误，需手动将这些数据更新为对应的枚举名称字符串（如把'0'改为'Type1'）。

之前配置无效的原因 #

• HasConversion<string>()未指定枚举到字符串的具体转换规则，EF Core默认会将枚举的数值转为字符串存储，而非枚举名称。
• 使用EnumToStringConverter时若未指定泛型参数<EntityTypes>，EF无法识别目标枚举类型，会 fallback 到默认的数值转字符串逻辑。

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