Blazor WASM .NET9编译报错NETSDK1082：缺失browser-wasm运行时包

问题场景 #

开发包含多项目的Blazor WebAssembly解决方案，执行dotnet build时触发以下错误：

error NETSDK1082: There was no runtime pack for Microsoft.AspNetCore.App available for the specified RuntimeIdentifier 'browser-wasm'.

解决方案结构 #

包含4个项目：

• RazorClassLibrary：共享组件
• TraningBlazorAPIProject：ASP.NET Core Web API
• TraningBlazorProject：Blazor Server（主入口）
• TraningBlazorProject.Client：Blazor WebAssembly前端

项目配置文件 #

TraningBlazorProject.Client.csproj #

<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
    <PropertyGroup>
        <TargetFramework>net9.0</TargetFramework>
        <RuntimeIdentifier>browser-wasm</RuntimeIdentifier>
        <ImplicitUsings>enable</ImplicitUsings>
        <UseBlazorWebAssembly>true</UseBlazorWebAssembly>
        <Nullable>enable</Nullable>
        <StaticWebAssetProjectMode>Default</StaticWebAssetProjectMode>
    </PropertyGroup>

   <ItemGroup>
        <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="9.0.3" />
        <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="9.0.3" />
        <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="9.0.3" />
    </ItemGroup>
</Project>

TraningBlazorProject.csproj #

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>

  <ItemGroup>
    <ProjectReference Include="..\RazorClassLibrary\RazorClassLibrary.csproj" />
    <ProjectReference Include="..\TraningBlazorProject.Client\TraningBlazorProject.Client.csproj" />
    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.Server" Version="9.0.3" />
  </ItemGroup>
</Project>

错误详情 #

TraningBlazorProject.Client failed with 1 error(s)

C:\Program Files\dotnet\sdk\9.0.202\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.FrameworkReferenceResolution.targets(512,5): error NETSDK1082: There was no runtime pack for Microsoft.AspNetCore.App available for the specified RuntimeIdentifier 'browser-wasm'.

已尝试的无效排查步骤 #

• 检查TraningBlazorProject.Client.csproj的FrameworkReference，确认未引用Microsoft.AspNetCore.App
• 移除TraningBlazorProject.csproj对TraningBlazorProject.Client.csproj的项目引用，编译仍报错
• 重新安装.NET workload：执行dotnet workload uninstall wasm-tools、dotnet workload install wasm-tools、dotnet workload repair
• 清理NuGet缓存并还原包：dotnet nuget locals all --clear、dotnet restore
• 删除bin/obj文件夹后重新编译：rd /s /q bin obj、dotnet clean、dotnet restore、dotnet build

问题解答 #

1. 为何Blazor WebAssembly（browser-wasm）会尝试引用仅适用于Blazor Server的Microsoft.AspNetCore.App？ #

根源是WASM项目中引用了**Microsoft.AspNetCore.Mvc.NewtonsoftJson**包——这个包属于ASP.NET Core服务器端组件，依赖Microsoft.AspNetCore.App框架，但browser-wasm运行时没有对应的Microsoft.AspNetCore.App运行时包，导致编译时找不到匹配的运行时资源。

Blazor WASM项目不需要服务器端的Mvc相关包，这类包是为ASP.NET Core后端设计的，不兼容浏览器运行时。

2. TraningBlazorProject.Client（Blazor WASM）与TraningBlazorProject（Blazor Server）是否存在冲突？ #

两者本身不存在冲突，很多托管式Blazor方案会同时包含Server项目（作为宿主）和WASM项目（作为前端）。你的错误并非来自项目引用冲突，而是WASM项目自身引入了不兼容的服务器端依赖包导致的。

3. 如何正确构建解决方案以避免该错误？ #

按以下步骤修改并重新编译：

1. 修正WASM项目的包引用：
   打开TraningBlazorProject.Client.csproj，移除Microsoft.AspNetCore.Mvc.NewtonsoftJson的引用；如果需要NewtonsoftJson支持，改用基础的Newtonsoft.Json包（而非Mvc绑定的版本）：

   <!-- 移除服务器端Mvc包 -->
   <!-- <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="9.0.3" /> -->
   <!-- 如需NewtonsoftJson，添加基础包 -->
   <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
   

2. 清理不必要的依赖：
   Microsoft.AspNetCore.JsonPatch是服务器端常用的包，若WASM项目不需要JsonPatch功能，可直接移除；如果需要保留，确认它在.NET 9 WASM环境下的兼容性（一般没问题，但需避免间接引入服务器端依赖）。
3. 重新编译项目：
   执行以下命令完成清理、还原与构建：

   dotnet clean
   dotnet restore
   dotnet build
   

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