EF Core+PostgreSQL实现单配置表的检查约束语法问题

问题原因 #

你遇到的错误是因为检查约束中值的比较语法不符合PostgreSQL的类型要求，同时可能混淆了boolean与bit列的类型差异。

正确实现方案 #

方案一：使用PostgreSQL布尔类型（推荐，更贴合业务语义） #

PostgreSQL的boolean类型专门用于存储真假值，比bit更适合此场景：

// 检查约束：强制列值为false（PostgreSQL布尔字面量直接写FALSE/true即可）
builder.ToTable(x => x.HasCheckConstraint("CK_Configuration_IsSingleRow", "is_single_row = FALSE"));
// 定义布尔类型阴影列（EF Core会自动将驼峰名转为蛇形命名is_single_row）
builder.Property<bool>("IsSingleRow")
       .HasDefaultValue(false)
       .IsRequired();
// 唯一索引：确保只有一行（固定值+唯一索引限制表最多一行）
builder.HasIndex("IsSingleRow").IsUnique();

注意：EF Core的Npgsql提供者默认会将C#驼峰命名转换为蛇形命名（如IsSingleRow→is_single_row），检查约束中需使用转换后的列名，或关闭命名转换（不推荐）。

方案二：使用bit(1)列（严格匹配你的需求） #

若必须使用bit列，需显式指定列类型，并使用PostgreSQL的位字面量语法：

// 检查约束：强制列值为0位（B'0'是PostgreSQL的bit类型字面量）
builder.ToTable(x => x.HasCheckConstraint("CK_Configuration_IsSingleRow", "is_single_row = B'0'"));
// 定义bit(1)类型阴影列，默认值设为0
builder.Property<byte>("IsSingleRow")
       .HasColumnType("bit(1)")
       .HasDefaultValue((byte)0)
       .IsRequired();
// 唯一索引限制单行
builder.HasIndex("IsSingleRow").IsUnique();

关键说明 #

• PostgreSQL中boolean列的比较需用布尔字面量（TRUE/FALSE，大小写不敏感），或单引号包裹的字符（'t'/'f'），不能直接用整数1/0（需显式转换：1::boolean）。
• bit列的字面量需用B'0'/B'1'格式，直接写整数或字符串会导致类型不匹配错误。

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