ASP.NET Web API 2项目dotnet命令执行失败GitHub workflow无法构建

问题根因 #

你遇到的报错核心原因是传统非SDK风格的.NET Framework项目（.csproj为老格式，包依赖写在packages.config中）不被dotnet CLI原生支持。Visual Studio可以正常构建是因为它内部调用了NuGet CLI做包恢复、MSBuild做项目编译，没有用跨平台的dotnet命令链。

解决方案1：调整GitHub Workflow配置，使用MSBuild + NuGet CLI（无需修改项目代码） #

• 首先确认Workflow的运行环境必须为windows-latest，.NET Framework仅支持在Windows系统上构建
• 替换原有的dotnet restore命令为nuget restore，该命令原生支持packages.config格式的包恢复
• 替换原有的dotnet build命令为MSBuild编译命令，示例如下：

msbuild 你的项目文件名.csproj /p:Configuration=Release /p:Platform="Any CPU"

如果找不到MSBuild路径，可以通过vswhere工具定位，GitHub Windows运行器已预装该工具，示例命令：

$msbuildPath = & "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe" -latest -products * -requires Microsoft.Component.MSBuild -find "MSBuild\**\Bin\MSBuild.exe" | select -first 1
& $msbuildPath 你的项目文件名.csproj /p:Configuration=Release /p:Platform="Any CPU"

解决方案2：迁移项目为SDK风格.csproj（可直接使用dotnet CLI） #

如果希望继续使用dotnet restore、dotnet build等跨平台命令，可以将老格式的.csproj项目升级为SDK风格：

• 修改.csproj文件头部为SDK声明格式，指定TargetFramework为net461
• 将packages.config中的所有包依赖转换为.csproj中的<PackageReference>节点
• 清理本地缓存后测试本地dotnet命令可正常运行后，再推送到CI执行

注意事项 #

• 确保项目中所有程序集引用使用相对路径，不要使用本地绝对路径，避免CI环境下找不到依赖
• 检查项目配置的平台（Any CPU/x86/x64）与MSBuild命令中指定的Platform参数一致

内容的提问来源于stack exchange，提问作者Setu Kumar Basak