EF Core + PostgreSQL 16：为可空Guid配置NULLS NOT DISTINCT唯一索引失败

你遇到的核心问题有两个：

• 实体中AdObjectId定义为Guid值类型，EF Core会默认生成非空的数据库字段，这意味着字段永远不会出现NULL，配置NULLS NOT DISTINCT自然不会生效
• 虽然迁移代码添加了"Npgsql:NullsDistinct", false注解，但因为字段本身非空，Npgsql不会在生成的DDL中包含NULLS NOT DISTINCT

修复步骤： #

1. 修改实体属性为可空Guid
   将AdObjectId的类型改为Guid?（可空值类型），这样EF Core才会生成允许NULL的数据库字段：

   public class Employee
   {
       [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
       public required Guid Id { get; set; }
       public required string FirstName { get; set; }
       public required string LastName { get; set; }
       public Guid? AdObjectId { get; set; } // 改为可空Guid
   }
   

2. 保留索引配置
   原有的索引配置无需修改：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       modelBuilder.Entity<Employee>()
           .HasIndex(e => e.AdObjectId)
           .IsUnique()
           .AreNullsDistinct(false);
   }
   

3. 重新生成迁移并更新数据库
   执行迁移命令后，生成的DDL将会包含NULLS NOT DISTINCT：

   create table "Employee"
   (
       "Id"         uuid                           not null
           constraint "PK_Employee" primary key,
       "FirstName"  text                           not null,
       "LastName"   text                           not null,
       "AdObjectId" uuid                           -- 不再有not null约束
   );
   
   create unique index "IX_Employee_AdObjectId"
       on "Employee" ("AdObjectId") NULLS NOT DISTINCT;
   

额外说明 #

PostgreSQL中00000000-0000-0000-0000-000000000000是一个有效的Guid值，并非NULL。如果你的业务逻辑中会用这个空Guid值表示“未关联AD”，仅靠NULLS NOT DISTINCT无法解决重复插入该值的问题，需要额外处理：

• 要么在业务层限制该值的重复插入
• 要么在数据库层面添加检查约束，禁止插入这个空Guid值，同时用NULL表示未关联状态

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