Azure DevOps中Asp.Net Core迁移脚本生成失败问题排查

问题根源 #

EF Core生成迁移脚本时需要明确数据库提供者（如SQL Server），默认情况下它会从配置文件（比如appsettings.json）读取连接字符串来推断提供者。你未添加appsettings.json，导致EF无法获取连接字符串，触发Value cannot be null. (Parameter 'connectionString')错误。

以下是几种无需添加永久appsettings.json的解决方案：

方案1：命令行直接指定连接字符串和提供者 #

在dotnet ef migrations script命令中直接追加--connection和--provider参数。连接字符串可以用占位符（不需要实际可连接的数据库，只要格式符合目标数据库要求），因为生成脚本不需要实际连接数据库，仅用来识别数据库类型。

修改后的流水线任务：

- task: DotNetCoreCLI@2
  displayName: 'Generate SQL Script'
  inputs:
    command: 'custom'
    custom: 'ef'
    arguments: 'migrations script --idempotent --project $(Build.SourcesDirectory)\Project\Project.csproj --output $(Build.ArtifactStagingDirectory)/migration.sql --connection "Server=.;Database=DummyDB;Trusted_Connection=True;" --provider Microsoft.EntityFrameworkCore.SqlServer'
    workingDirectory: '$(Build.SourcesDirectory)/Project'

• 若使用其他数据库（如MySQL），替换对应的--provider值和连接字符串格式即可。

方案2：通过环境变量传递连接字符串 #

EF Core会自动读取环境变量中的配置，你可以在流水线中临时设置连接字符串的环境变量，无需修改项目文件。

直接在DotNetCoreCLI任务中嵌入环境变量：

- task: DotNetCoreCLI@2
  displayName: 'Generate SQL Script'
  inputs:
    command: 'custom'
    custom: 'ef'
    arguments: 'migrations script --idempotent --project $(Build.SourcesDirectory)\Project\Project.csproj --output $(Build.ArtifactStagingDirectory)/migration.sql'
    workingDirectory: '$(Build.SourcesDirectory)/Project'
  env:
    ConnectionStrings__DefaultConnection: "Server=.;Database=DummyDB;Trusted_Connection=True;"

• 这里的ConnectionStrings__DefaultConnection对应你DbContext中配置的连接字符串名称（如果DbContext用GetConnectionString("DefaultConnection")读取，就用这个环境变量名）。

方案3：临时生成appsettings.json（可选） #

如果偏好配置文件的方式，可以在流水线中用PowerShell临时生成仅包含连接字符串的appsettings.json，生成脚本后可删除：

- task: PowerShell@2
  displayName: 'Create temporary appsettings.json'
  inputs:
    targetType: 'inline'
    script: |
      '{
        "ConnectionStrings": {
          "DefaultConnection": "Server=.;Database=DummyDB;Trusted_Connection=True;"
        }
      }' | Out-File "$(Build.SourcesDirectory)/Project/appsettings.json"
    workingDirectory: '$(Build.SourcesDirectory)/Project'

- task: DotNetCoreCLI@2
  displayName: 'Generate SQL Script'
  inputs:
    command: 'custom'
    custom: 'ef'
    arguments: 'migrations script --idempotent --project $(Build.SourcesDirectory)\Project\Project.csproj --output $(Build.ArtifactStagingDirectory)/migration.sql'
    workingDirectory: '$(Build.SourcesDirectory)/Project'

# 可选：生成脚本后删除临时文件
- task: PowerShell@2
  displayName: 'Remove temporary appsettings.json'
  inputs:
    targetType: 'inline'
    script: Remove-Item "$(Build.SourcesDirectory)/Project/appsettings.json" -Force
    workingDirectory: '$(Build.SourcesDirectory)/Project'

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