如何配置EF Core 5使Guid主键由SQL Server生成及迁移无变更问题解析

首先，你的困惑完全合理——EF Core 5在这里的迁移检测逻辑有点“偷懒”，我来拆解原因和解决办法：

为什么迁移代码为空？ #

当你给Id属性添加[DatabaseGenerated(DatabaseGeneratedOption.Identity)]特性后，EF Core对比现有数据库结构（第一次迁移创建的People表）时，发现：

• 列类型还是uniqueidentifier，可空性还是NOT NULL，主键约束也存在
• EF Core 5默认不会自动检测到需要给Guid列添加数据库端的默认生成规则（也就是DEFAULT NEWSEQUENTIALID()），所以它认为数据库结构不需要变更，因此生成空的迁移。

要知道，客户端生成Guid和数据库生成Guid的核心差异，在于数据库列是否配置了自动生成的默认值——而这个默认值的配置，EF不会仅仅因为你加了特性就自动为已存在的列补上。

如何配置让数据库自动生成Guid主键？ #

这里有两种可靠的解决方式：

方式1：手动修改迁移代码（适合已存在的表） #

既然自动生成的迁移是空的，你可以手动添加AlterColumn的逻辑，让数据库列启用Identity生成：

public partial class PersonIdentityGuid : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.AlterColumn<Guid>(
            name: "Id",
            table: "People",
            type: "uniqueidentifier",
            nullable: false,
            defaultValueSql: "NEWSEQUENTIALID()", // 关键：添加数据库默认值
            oldClrType: typeof(Guid),
            oldType: "uniqueidentifier")
            .Annotation("SqlServer:Identity", "true"); // 标记为数据库生成的Identity
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.AlterColumn<Guid>(
            name: "Id",
            table: "People",
            type: "uniqueidentifier",
            nullable: false,
            oldClrType: typeof(Guid),
            oldType: "uniqueidentifier",
            oldDefaultValueSql: "NEWSEQUENTIALID()")
            .OldAnnotation("SqlServer:Identity", "true");
    }
}

执行update-database后，数据库的Id列就会带上DEFAULT NEWSEQUENTIALID()的约束，后续插入数据时EF会自动跳过客户端生成Guid，由数据库生成。

方式2：使用Fluent API配置（推荐，更清晰且能自动生成正确迁移） #

如果你还没创建初始迁移，或者愿意重新调整配置，用Fluent API在DbContext的OnModelCreating里配置，EF能正确识别需要的数据库变更：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Person>(entity =>
    {
        entity.Property(p => p.Id)
            .IsRequired()
            .ValueGeneratedOnAdd() // 等价于DatabaseGeneratedOption.Identity
            .HasDefaultValueSql("NEWSEQUENTIALID()"); // 指定SQL Server的生成规则
    });
}

此时再创建迁移，EF会自动生成包含默认值配置的迁移代码，无需手动修改。

补充说明 #

• SQL Server里NEWSEQUENTIALID()比NEWID()更适合做主键，因为它生成的Guid是连续的，能减少索引碎片，提升性能——EF Core在识别到ValueGeneratedOnAdd()或DatabaseGeneratedOption.Identity时，默认会使用NEWSEQUENTIALID()，但显式指定HasDefaultValueSql会更明确。
• 如果你是从头开始（没有初始迁移），直接用特性+Fluent API的组合，EF会在第一次迁移时就创建带默认值的Id列，不会出现后续迁移为空的问题。

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