Azure DevOps中EF Core迁移脚本GUID主键报错问题求助

问题分析 #

本地运行EF Core迁移正常，但Azure DevOps流水线生成脚本时报错，核心原因通常是环境版本不一致、数据库生成策略配置不完整或流水线参数有误。

具体解决方案 #

• 确保EF Core版本完全一致
  本地开发环境和流水线中使用的dotnet ef工具版本，必须与项目引用的EF Core NuGet包版本完全匹配。流水线中可以先安装指定版本的工具再执行迁移命令：

  - script: 'dotnet tool install --global dotnet-ef --version 6.0.25'
    displayName: Install specific EF Core tool version
  - script: 'dotnet ef migrations script --idempotent --output migrations.sql --project "YourProject.csproj" --context "YourDbContext"'
    displayName: Create EF migration Script
  

• 完善GUID主键的数据库生成策略配置
  仅设置ValueGeneratedOnAdd()不足以让EF Core识别数据库层面的GUID生成逻辑，需要明确指定数据库默认值：

  // Fluent API配置方式
  modelBuilder.Entity<users>()
      .Property(p => p.id)
      .HasDefaultValueSql("NEWSEQUENTIALID()") // SQL Server专用，生成有序GUID
      .ValueGeneratedOnAdd();
  

  如果使用DataAnnotations，确保特性正确且数据库列配置匹配：

  [Key]
  [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
  public Guid id { get; set; }
  

  同时确认数据库中该列的类型是uniqueidentifier，且默认值为NEWSEQUENTIALID()。

• 检查数据库提供者配置
  确保DbContext配置的是支持GUID Identity的数据库提供者（如SQL Server），避免误用其他不支持的提供者：

  builder.Services.AddDbContext<YourDbContext>(options =>
      options.UseSqlServer(builder.Configuration.GetConnectionString("YourConnStr")));
  

• 清理旧迁移文件并重新生成
  删除项目中Migrations文件夹下的所有旧迁移文件，本地执行dotnet ef migrations add InitialCreate重新生成迁移，提交到代码仓库后再让流水线执行脚本生成。

• 修正流水线命令参数
  确保--project和--context参数填写正确的项目路径和上下文类名，避免空值或错误路径导致EF Core无法正确识别实体配置。

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