升级.NET Core 3.1.405 SDK后执行dotnet run报GenerateDepsFile错误
.NET SDK 3.1.405 编译报MSB4018缺失
Microsoft.DotNet.PlatformAbstractions的解决方案 问题触发场景
升级.NET Core SDK至3.1.405后,任意项目目录下执行dotnet run均编译失败,所有项目均可复现(包括空白新建的netcoreapp3.1控制台项目)。
核心报错信息如下:
C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: The "GenerateDepsFile" task failed unexpectedly. [C:\Users\<UserName>\Desktop\Test\Test.csproj] C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.DotNet.PlatformAbstractions, Version=2.1.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. The system cannot find the file specified. [C:\Users\<UserName>\Desktop\Test\Test.csproj] C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: File name: 'Microsoft.DotNet.PlatformAbstractions, Version=2.1.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60' [C:\Users\<UserName>\Desktop\Test\Test.csproj] C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: at Microsoft.NET.Build.Tasks.FrameworkReferenceResolver.GetDefaultReferenceAssembliesPath() [C:\Users\<UserName>\Desktop\Test\Test.csproj] C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: at Microsoft.NET.Build.Tasks.GenerateDepsFile.WriteDepsFile(String depsFilePath) [C:\Users\<UserName>\Desktop\Test\Test.csproj] C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: at Microsoft.NET.Build.Tasks.GenerateDepsFile.ExecuteCore() [C:\Users\<UserName>\Desktop\Test\Test.csproj] C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: at Microsoft.NET.Build.Tasks.TaskBase.Execute() [C:\Users\<UserName>\Desktop\Test\Test.csproj] C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: at Microsoft.Build.BackEnd.TaskExecutionHost.Microsoft.Build.BackEnd.ITaskExecutionHost.Execute() [C:\Users\<UserName>\Desktop\Test\Test.csproj] C:\Program Files\dotnet\sdk\3.1.405\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.targets(194,5): error MSB4018: at Microsoft.Build.BackEnd.TaskBuilder.ExecuteInstantiatedTask(ITaskExecutionHost taskExecutionHost, TaskLoggingContext taskLoggingContext, TaskHost taskHost, ItemBucket bucket, TaskExecutionMode howToExecuteTask) [C:\Users\<UserName>\Desktop\Test\Test.csproj] The build failed. Fix the build errors and run again.
复现问题的最简项目配置:
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>netcoreapp3.1</TargetFramework> </PropertyGroup> </Project>
已验证无效的排查操作
- 重新安装SDK
- 降级至更早的3.1.x版本SDK
- 清理NuGet缓存
- 执行项目级
dotnet clean命令 - 安装Mono 6.x版本
- 删除
C:\Users\<UserName>\.nuget\packages目录下的本地NuGet缓存
当前环境配置
执行dotnet --info返回的环境状态:
.NET SDK (reflecting any global.json): Version: 5.0.102 Commit: 71365b4d42 Runtime Environment: OS Name: Windows OS Version: 10.0.19041 OS Platform: Windows RID: win10-x64 Base Path: C:\Program Files\dotnet\sdk\5.0.102\ Host (useful for support): Version: 5.0.2 Commit: cb5f173b96 .NET SDKs installed: 3.1.405 [C:\Program Files\dotnet\sdk] 5.0.102 [C:\Program Files\dotnet\sdk] .NET runtimes installed: Microsoft.AspNetCore.All 2.1.24 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.All] Microsoft.AspNetCore.App 2.1.24 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] Microsoft.AspNetCore.App 3.1.3 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] Microsoft.AspNetCore.App 3.1.11 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] Microsoft.AspNetCore.App 5.0.2 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] Microsoft.NETCore.App 2.1.24 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] Microsoft.NETCore.App 3.1.3 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] Microsoft.NETCore.App 3.1.11 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] Microsoft.NETCore.App 5.0.2 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] Microsoft.WindowsDesktop.App 3.1.3 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App] Microsoft.WindowsDesktop.App 3.1.11 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App] Microsoft.WindowsDesktop.App 5.0.2 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
关键特征:系统全局默认SDK优先级为5.0.102,高于已安装的3.1.405版本
根因定位
该问题并非SDK文件损坏导致,核心是版本加载逻辑冲突:
- 3.1.405版本SDK内置的
GenerateDepsFile编译任务,强依赖Microsoft.DotNet.PlatformAbstractions 2.1.0.0程序集,该组件仅在.NET Core 2.1/3.1早期版本SDK的内置加载路径中分发,.NET 5.0及以上版本SDK已完全移除对该组件的内置支持 - 当系统默认SDK为5.0.102时,即使项目目标框架是netcoreapp3.1,MSBuild仍会优先全局加载高版本SDK的任务基础逻辑,导致3.1 SDK要求的低版本依赖程序集无法被正确检索,触发文件找不到的异常
解决步骤
- 在项目根目录添加
global.json配置文件,强制指定项目编译使用的SDK版本,绕开全局SDK优先级的干扰,参考配置:
{ "sdk": { "version": "3.1.405", "rollForward": "latestMajor" } }
- 配置完成后,在项目目录执行
dotnet --version,确认返回值为3.1.405后,再执行dotnet run即可正常完成编译 - 若添加配置后仍报错,可手动检查SDK安装目录
C:\Program Files\dotnet\sdk\3.1.405,确认子目录下是否存在Microsoft.DotNet.PlatformAbstractions.dll文件,若文件缺失可通过3.1.405官方安装包修复对应安装路径
内容的提问来源于stack exchange,提问作者Lele Edgo
相关产品推荐
相关产品推荐

