EF 6.2多复合索引生成异常：TenantId未纳入索引？如何修复？

最近配置EF Core的Payment实体时遇到了个头疼的小问题，先把相关代码贴出来：

我的实体及EF配置代码 #

public class Payment { 
    public Guid Id { get; set; } 
    public Guid TenantId { get; set; } 
    public string ExternalPaymentId { get; set; } 
    public string PaymentId { get; set; } 
    public Tenant Tenant { get; set; } 
}

// 配置复合主键（聚集索引）
modelBuilder.Entity<Payment>()
    .HasKey(e => new { e.TenantId, e.Id }, config => config.IsClustered(true));

// 配置TenantId+ExternalPaymentId的复合唯一索引
modelBuilder.Entity<Payment>()
    .HasIndex(e => new { e.TenantId, e.ExternalPaymentId })
    .IsUnique(true);

// 配置TenantId+PaymentId的复合唯一索引
modelBuilder.Entity<Payment>()
    .HasIndex(e => new { e.TenantId, e.PaymentId })
    .IsUnique(true);

EF生成的迁移代码（有问题的版本） #

CreateTable(
    "dbo.Payments",
    .............................
    .PrimaryKey(t => new { t.TenantId, t.Id })
    .Index(t => new { t.TenantId, t.PaymentId }, unique: true)
    .Index(t => t.ExternalPaymentId, unique: true, name: "IX_TenantId_ExternalPaymentId");

可以看到，原本应该是TenantId+ExternalPaymentId的复合索引，生成后变成了只包含ExternalPaymentId的单列索引，这明显不符合预期。

问题原因 #

这其实是EF Core的自动命名逻辑导致的解析冲突：
当你没有显式指定索引名称时，EF会自动生成类似IX_TenantId_ExternalPaymentId的名字。但这个名字的前缀IX_TenantId会被EF的迁移生成逻辑误判为“这是一个针对TenantId的单列索引”，进而在生成迁移代码时错误地丢弃了复合索引中的TenantId列，只保留了ExternalPaymentId。

简单来说就是自动生成的索引名称引发了歧义，让EF搞错了索引的列组成。

修复方案 #

解决方法非常直接：给复合索引手动指定一个不会产生歧义的唯一名称，避免EF自动生成可能引发误解的名字。

修改你的EF配置代码，给TenantId+ExternalPaymentId的索引添加显式命名：

modelBuilder.Entity<Payment>()
    .HasIndex(e => new { e.TenantId, e.ExternalPaymentId })
    .IsUnique(true)
    .HasName("IX_Payments_TenantId_ExternalPaymentId"); // 显式指定索引名

重新生成迁移后，EF就能正确识别这是一个复合索引了，生成的迁移代码会变成：

CreateTable(
    "dbo.Payments",
    .............................
    .PrimaryKey(t => new { t.TenantId, t.Id })
    .Index(t => new { t.TenantId, t.PaymentId }, unique: true)
    .Index(t => new { t.TenantId, e.ExternalPaymentId }, unique: true, name: "IX_Payments_TenantId_ExternalPaymentId");

这样就完美解决了索引缺失列的问题～

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