.NET 5应用NuGet更新后运行报错：无法加载指定System.Web类型

问题原因 #

System.Web.UI.ParseChildrenAttribute是.NET Framework专属System.Web程序集里的类型，而.NET 5属于跨平台的.NET Core衍生版本，本身不包含该程序集。出现此错误的核心原因是更新后的某个NuGet包（或其传递依赖）引入了仅.NET Framework支持的System.Web组件，导致运行时无法找到对应类型。

解决方案步骤 #

1. 定位依赖来源 #

执行以下命令查看项目完整依赖树，找出引入System.Web的包：

dotnet list package --include-transitive

在输出中搜索System.Web，定位到直接或间接依赖它的NuGet包。

2. 排查更新的包 #

对比NuGet更新前后的包版本列表（可查看packages.lock.json文件），确定是哪个包更新后引入了不兼容依赖。重点关注ASP.NET相关、UI控件类的包，这类包容易出现.NET Framework与.NET 5的兼容问题。

3. 替换或移除问题包 #

• 替换兼容包：如果找到的包有.NET 5/.NET Core版本的替代，直接替换为对应版本。例如，原依赖System.Web的ASP.NET控件包，可替换为Microsoft.AspNetCore.UI相关的包。
• 排除不必要依赖：如果某个包仅部分功能依赖System.Web，但你的项目未使用该部分，可在项目文件（.csproj）中添加排除配置：

<PackageReference Include="ProblematicPackageName" Version="x.x.x">
  <ExcludeAssets>all</ExcludeAssets>
  <PrivateAssets>all</PrivateAssets>
</PackageReference>

• 强制移除System.Web引用：若确认项目无需System.Web，可在项目文件中添加：

<ItemGroup>
  <Reference Remove="System.Web" />
</ItemGroup>

4. 清理重建项目 #

执行以下命令清理缓存并重新恢复依赖：

dotnet clean
dotnet restore
dotnet build --no-incremental

5. 确认项目目标框架 #

检查项目文件中的目标框架配置，确保是正确的.NET 5：

<TargetFramework>net5.0</TargetFramework>

避免出现同时目标.NET Framework和.NET 5的混合配置。

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