基于Azure DevOps的EF Core 6.0.10 PostgreSQL增量迁移方案咨询

结合Azure DevOps流程使用Entity Framework Core 6.0.10进行PostgreSQL数据库迁移操作时，首次执行dotnet ef migrations add和dotnet ef database update命令成功，但第二次执行迁移时出现错误：

Table 'name' already exists

已尝试以下方法但均无法实现增量更新：

• 直接执行dotnet ef database update
• 调整流水线打包流程
• 生成SQL脚本后手动更新数据库

删除数据库重新部署可解决问题，但并非最优方案，希望从DevOps视角获取实现增量迁移和更新数据库的可行方法。

1. 保障迁移历史表的有效性 #

EF Core在PostgreSQL中依赖__EFMigrationsHistory表记录已应用的迁移，若该表缺失、记录被篡改或执行账号无读写权限，会导致EF Core误判迁移状态，重复创建对象。

• 检查数据库中__EFMigrationsHistory表是否存在，确认表内迁移记录与本地项目中的迁移文件完全匹配
• 在Azure DevOps部署任务中，确保执行迁移的数据库账号拥有该表的读写权限

2. 采用幂等迁移脚本+受控执行流程 #

放弃直接在流水线中执行dotnet ef database update，改为生成幂等脚本后执行，从根源避免重复创建对象：

• 流水线步骤：
  1. 执行dotnet ef migrations script --idempotent --output migrations.sql生成幂等脚本（脚本会自动判断数据库对象是否存在，仅执行必要的变更）
  2. 通过Azure PostgreSQL任务或自定义脚本任务执行生成的migrations.sql
• 优势：脚本可审计、可回滚，DevOps流程中可加入代码审查环节，提前发现问题

3. 流水线中增加迁移状态校验逻辑 #

在执行迁移前先校验数据库当前的迁移状态，仅执行未应用的迁移：

• 用dotnet ef migrations list --connection <数据库连接字符串>获取已应用的迁移列表
• 对比本地项目中的迁移文件，筛选出未应用的迁移后再执行更新（可通过PowerShell/Bash脚本自动化实现）
• 示例Bash脚本片段：

  # 获取本地所有迁移名称
  local_migrations=$(dotnet ef migrations list | grep -v "Applied")
  # 获取已应用的迁移名称
  applied_migrations=$(dotnet ef migrations list --connection $DB_CONN | grep "Applied" | awk '{print $1}')
  # 计算未应用的迁移
  pending_migrations=$(comm -23 <(echo "$local_migrations" | sort) <(echo "$applied_migrations" | sort))
  # 仅执行未应用的迁移
  if [ -n "$pending_migrations" ]; then
      dotnet ef database update --connection $DB_CONN
  fi
  

4. 固化迁移文件的生成流程 #

禁止在Azure DevOps流水线中执行dotnet ef migrations add，迁移文件必须由开发人员在本地创建并提交至代码仓库：

• 开发流程：修改实体模型→本地创建迁移文件→提交Git→流水线仅负责执行迁移更新
• 原因：流水线动态生成迁移文件会导致环境不一致，易产生重复或错误的迁移脚本

5. 已出现重复创建错误的补救方法 #

若已触发Table already exists错误，可手动修复迁移历史表恢复正常：

• 找到报错迁移文件的ID（即文件名前缀，如20240520123456_AddUserTable中的20240520123456）
• 手动向__EFMigrationsHistory表插入对应记录（确保MigrationId和ProductVersion与迁移文件一致）：

  INSERT INTO __EFMigrationsHistory (MigrationId, ProductVersion)
  VALUES ('20240520123456_AddUserTable', '6.0.10');
  

• 之后再执行dotnet ef database update即可正常进行增量迁移

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