如何通过EF Fluent API为PostgreSQL表添加大小写不敏感的唯一索引

API 探路者

2026-8-9

在EF Core中实现PostgreSQL大小写不敏感的唯一索引

要实现PostgreSQL中字符串值的大小写不敏感唯一性，你需要创建基于UPPER(UniqueValue)表达式的唯一索引，下面是两种可行的实现方式：

方法一：通过EF Core Fluent API配置（EF Core 5.0+）

EF Core 5.0及以上版本支持为索引指定计算表达式，你可以直接在OnModelCreating中使用EF.Functions.Upper来定义索引：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<MyTable>()
        .HasIndex(e => EF.Functions.Upper(e.UniqueValue))
        .IsUnique()
        .HasDatabaseName("UniqueValue"); // 匹配PostgreSQL索引名
    
    base.OnModelCreating(modelBuilder);
}

执行Add-Migration生成迁移后，PostgreSQL Provider会自动将表达式转换为对应的SQL语法，生成包含UPPER函数的索引创建代码。

方法二：手动修改迁移文件

如果Fluent API无法自动生成目标代码，你可以先生成基础迁移，再手动调整索引创建逻辑：

执行Add-Migration生成初始迁移（基于你原来的Fluent API配置）
打开迁移文件，修改Up方法中的CreateIndex参数，使用PostgreSQL的表达式语法：

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.CreateIndex(
        name: "UniqueValue",
        table: "MyTable",
        column: "(UPPER(\"UniqueValue\"))", // 用PostgreSQL函数表达式定义索引列
        unique: true);
}

同步修改Down方法，确保能正确删除该索引：

protected override void Down(MigrationBuilder migrationBuilder)
{
    migrationBuilder.DropIndex(
        name: "UniqueValue",
        table: "MyTable");
}