Azure DevOps发布流水线中EF6 Code First数据库更新任务报错解决

一、先解决.NET SDK识别问题 #

Azure DevOps代理机器默认可能未预装对应版本的.NET SDK，或者环境变量未正确配置，可通过以下两种方式处理：

方式1：使用Azure DevOps官方任务（推荐） #

在执行dotnet tool install的命令行任务之前，添加「Use .NET」任务：

• 任务参数中选择你项目依赖的.NET SDK版本（比如6.x、7.x，需与dotnet-ef版本匹配）
• 无需额外配置路径，任务会自动将SDK添加到代理机器的环境变量中

方式2：脚本手动安装并配置环境 #

如果不想用官方任务，可在命令行任务的开头添加以下PowerShell脚本（以安装.NET 6.0 SDK为例）：

# 下载.NET安装脚本
Invoke-WebRequest -Uri https://dot.net/v1/dotnet-install.ps1 -OutFile dotnet-install.ps1
# 安装指定版本的SDK到系统目录
.\dotnet-install.ps1 -Version 6.0.417 -InstallDir $env:ProgramFiles\dotnet
# 将dotnet命令路径加入环境变量
$env:PATH = "$env:ProgramFiles\dotnet;$env:PATH"
# 验证SDK安装成功
dotnet --version

之后再执行dotnet tool install --global dotnet-ef --version <对应版本号>

二、重要提醒：EF6 Code First不适用dotnet-ef命令 #

你提到的是Entity Framework 6的Code First迁移，dotnet-ef是EF Core的工具，两者不兼容。针对EF6，推荐以下两种部署时更新数据库的方案：

方案1：使用PowerShell执行EF6迁移 #

添加PowerShell任务，执行以下脚本：

# 安装EF6 PowerShell模块
Install-Module EntityFramework -Force
# 切换到项目根目录（替换为你的项目路径）
cd $(System.DefaultWorkingDirectory)/YourMvcProject
# 执行数据库更新，替换为对应环境的连接字符串
Update-Database -ConnectionString "Server=your-sql-server;Database=your-db;User Id=xxx;Password=xxx;" -ConnectionProviderName "System.Data.SqlClient" -Verbose

方案2：创建迁移执行控制台应用（更稳定） #

在解决方案中新增一个控制台项目，引用你的MVC项目的EF6上下文，编写代码执行迁移：

using System.Data.Entity;
using YourMvcProject.Data;

namespace MigrationRunner
{
    class Program
    {
        static void Main(string[] args)
        {
            var connectionString = args[0];
            Database.SetInitializer(new MigrateDatabaseToLatestVersion<YourDbContext, YourMvcProject.Migrations.Configuration>());
            using (var context = new YourDbContext(connectionString))
            {
                context.Database.Initialize(true);
            }
        }
    }
}

然后在流水线中添加「.NET Core CLI」任务，运行这个控制台应用并传入对应环境的连接字符串：

dotnet run --project MigrationRunner/MigrationRunner.csproj "Server=your-sql-server;Database=your-db;User Id=xxx;Password=xxx;"

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