Npgsql映射Enum仍被转为整数的技术问题排查

你的问题核心是EF Core默认不会将jsonb数组内嵌套对象的枚举属性识别为PostgreSQL枚举类型，而是自动转为整数，导致LINQ表达式无法被正确翻译。以下是具体解决方案：

1. 确认数据库中已创建对应枚举类型 #

首先验证PostgreSQL数据库中是否存在activityfield枚举（PostgreSQL枚举名默认小写），执行以下SQL查询：

SELECT typname FROM pg_type WHERE typname = 'activityfield';

如果不存在，需手动创建或通过EF迁移生成：

CREATE TYPE activityfield AS ENUM ('Clients', /* 替换为你的其他枚举成员 */);

注意枚举成员名称要与CLR枚举ActivityField的成员完全一致（大小写敏感）。

2. 显式配置jsonb嵌套属性的枚举映射 #

由于Filters是jsonb数组，EF Core无法自动识别其中的Field属性为PostgreSQL枚举，需在OnModelCreating中对嵌套对象的属性进行显式配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 注册PostgreSQL枚举
    modelBuilder.HasPostgresEnum<ActivityField>();

    // 配置AnalyticsQueries实体的Filters列为jsonb类型
    modelBuilder.Entity<AnalyticsQueries>()
        .Property(x => x.Filters)
        .HasColumnType("jsonb");

    // 关键：指定嵌套FilterObject的Field属性映射为PostgreSQL枚举
    modelBuilder.Entity<AnalyticsQueries>()
        .OwnsMany(x => x.Filters, builder =>
        {
            builder.Property(f => f.Field)
                .HasColumnType("activityfield"); // 与数据库枚举名一致（小写）
        });
}

通过OwnsMany告诉EF Core，Filters数组中每个对象的Field属性应映射为PostgreSQL的activityfield枚举类型，而非默认的整数。

3. 确保Npgsql数据源正确使用枚举映射 #

验证NpgsqlDataSource的枚举映射已正确配置，且DbContext使用了该数据源：

// 构建数据源时映射枚举
var dataSourceBuilder = new NpgsqlDataSourceBuilder(connStr);
dataSourceBuilder.MapEnum<ActivityField>();
var dataSource = dataSourceBuilder.Build();

// 注册DbContext时关联该数据源
services.AddDbContext<YourDbContext>(options =>
    options.UseNpgsql(dataSource));

4. 可选：调整LINQ查询写法 #

如果上述配置仍有问题，可直接通过字符串匹配jsonb中的枚举值，避免EF自动转换为整数：

var analyticsQueriesWithClientsFilter = _db.AnalyticsQueries
    .Where(x => x.Filters.Any(f => f.Field.ToString() == nameof(ActivityField.Clients)));

这种写法会生成匹配jsonb字符串值的SQL，绕过枚举类型转换的翻译问题。

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