Entity Framework Core 5设置Unique Constraint后迁移未生成对应规则

问题原因 #

• Email字段默认生成nvarchar(max)类型，SQL Server 不支持对max长度的可变字符串类型创建索引，EF Core 检测到该情况会自动跳过索引生成。SQL Server 非聚集索引的键值最大长度限制为900字节，nvarchar(max)长度不受限无法满足该要求。
• 若使用[Index]特性配置，EF Core 5 要求必须安装Microsoft.EntityFrameworkCore.Abstractions包，且版本与你使用的EF Core主版本（5.0.11）完全一致，否则特性无法被模型构建器识别。
• 之前生成的迁移缓存未清理，或者执行迁移命令时指定的DbContext错误，导致配置未被读取。

解决方案 #

步骤1：给Email字段设置合理的长度限制 #

字符串类型字段必须设置小于900字节的长度限制才能创建索引，按照通用业务规则设置为256位即可，可通过数据注解或Fluent API配置：

// 数据注解方式，加在Email属性上
[MaxLength(256)]
public string Email { get; set; }

// Fluent API方式，写在OnModelCreating方法内
modelBuilder.Entity<User>()
    .Property(b => b.Email)
    .IsRequired() // 可根据业务需求选择是否加非空限制
    .HasMaxLength(256);

步骤2：确认索引配置正确 #

两种配置二选一即可，不要重复配置：

方案A：Fluent API 配置（推荐）

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 先配置字段属性
    modelBuilder.Entity<User>()
        .Property(b => b.Email)
        .IsRequired()
        .HasMaxLength(256);
    // 再配置唯一索引
    modelBuilder.Entity<User>()
        .HasIndex(b => b.Email)
        .IsUnique();
}

方案B：特性配置

确认已经安装版本匹配的Microsoft.EntityFrameworkCore.Abstractions包后，修改实体类：

[Index(nameof(Email), IsUnique = true)]
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    [MaxLength(256)]
    public string Email { get; set; }
}

步骤3：清理旧迁移重新生成 #

删除之前生成的有问题的迁移文件，再执行迁移命令：

• 包管理器控制台命令：

Add-Migration AddUniqueIndexToUserEmail
Update-Database

• Dotnet CLI命令：

dotnet ef migrations add AddUniqueIndexToUserEmail
dotnet ef database update

重新生成的迁移代码中会自动包含创建唯一索引的相关配置。

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