Azure YAML Pipeline部署EF Core Migrations遇GetEFProjectMetadata错误的解决

针对你遇到的问题，以下是具体的排查和解决步骤：

1. 明确指定EF命令的目标项目与启动项目 #

流水线执行dotnet ef命令时，默认会使用当前工作目录的项目，但你的解决方案包含Server和Client两个项目，必须明确指定Server项目路径：

dotnet ef migrations script --project ./Server/YourServerProject.csproj --startup-project ./Server/YourServerProject.csproj --output ./migrations.sql --context YourDbContext

• --project：指定包含DbContext和迁移的Server项目
• --startup-project：指定读取配置（如连接字符串）的启动项目，通常和Server项目一致
• --context：如果有多个DbContext，必须指定目标上下文

2. 确保先完成Server项目的构建与还原 #

EF生成脚本依赖构建后的项目元数据，流水线中必须先单独构建Server项目（不要仅构建整个解决方案）：

# 还原Server项目依赖
- task: DotNetCoreCLI@2
  inputs:
    command: 'restore'
    projects: './Server/YourServerProject.csproj'

# 构建Server项目
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: './Server/YourServerProject.csproj'
    arguments: '--configuration Release'

3. 修正MSBuild项目扩展路径的用法 #

如果必须指定--msbuildprojectextensionspath，要确保路径相对于Server项目目录：

- script: |
    cd ./Server
    dotnet ef migrations script --msbuildprojectextensionspath ./obj/Release --output ../migrations.sql --context YourDbContext
  displayName: 'Generate EF Migration Script'

• 先切换到Server项目目录再执行命令，避免路径混淆
• 路径要对应构建配置（比如Release构建就用obj/Release）

4. 对齐本地与流水线的EF Tool版本 #

确保流水线安装的dotnet-ef版本和本地使用的完全一致：

- script: dotnet tool install --global dotnet-ef --version 6.0.25
  displayName: 'Install EF Core Tool'

• 本地执行dotnet ef --version查看当前版本，替换命令中的版本号

5. 检查Server项目的EF包引用 #

确认Server项目的.csproj文件中包含EF Core设计时包：

<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="6.0.25">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
</PackageReference>

这个包是dotnet ef命令依赖的核心设计时组件，缺失会导致元数据目标找不到的错误。

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