如何用C# Entity Framework Core迁移创建PostgreSQL小写索引

问题背景 #

我尝试通过EntityFrameworkCore.Migrations为PostgreSQL数据库的users表创建基于小写用户名的索引，最初在OnModelCreating中写了如下代码：

modelBuilder.Entity<users>()
    .HasIndex(b => b.username.ToLower())

但触发了错误：

System.ArgumentException: The expression 'user => user.username.ToLower()' is not a valid member access expression. The expression should represent a simple property or field access: 't => t.MyProperty'. 

想确认是否只能通过自定义迁移SQL实现，比如：

migrationBuilder.Sql("CREATE UNIQUE INDEX lower_case_username ON users ((lower(username)));");

可行的实现方式 #

1. 使用EF Core内置函数表达式（推荐，EF Core 3.0+适用） #

EF Core 3.0及以上版本支持在索引定义中使用数据库函数，用EF.Functions.Lower替代string.ToLower()，EF能正确解析并生成对应的迁移脚本：

using Microsoft.EntityFrameworkCore;

// OnModelCreating配置
modelBuilder.Entity<users>()
    .HasIndex(u => EF.Functions.Lower(u.username))
    .IsUnique() // 若需要唯一约束则添加
    .HasDatabaseName("lower_case_username");

执行迁移命令后，EF会自动生成包含lower(username)的索引创建语句，无需手动编写SQL。

2. 自定义迁移SQL（兼容所有EF Core版本） #

如果你的EF Core版本较低，或者需要高度自定义索引逻辑，直接使用migrationBuilder.Sql是完全可行的方案：

migrationBuilder.Sql("CREATE UNIQUE INDEX lower_case_username ON users ((lower(username)));");

注意：若需要回滚迁移，需在对应的Down方法中添加索引删除语句：

migrationBuilder.Sql("DROP INDEX lower_case_username ON users;");

3. 计算列映射（适合需频繁使用小写用户名的场景） #

可以在实体类中添加计算列属性，映射到PostgreSQL的lower(username)表达式，再对该列创建索引：

public class users
{
    public string username { get; set; }
    
    [DatabaseGenerated(DatabaseGeneratedOption.Computed)]
    public string LowerUsername { get; set; } // 仅作为数据库计算列的映射，无需手动赋值
}

在OnModelCreating中配置计算列的数据库逻辑：

modelBuilder.Entity<users>()
    .Property(u => u.LowerUsername)
    .HasComputedColumnSql("lower(username)", stored: true); // stored=true会将计算值持久化，提升查询性能

modelBuilder.Entity<users>()
    .HasIndex(u => u.LowerUsername)
    .IsUnique();

这种方式的优势是可以直接在LINQ查询中使用LowerUsername属性，EF会自动转换为对应的数据库函数调用。

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