.NET Core Web API调用含System.Web.HttpContext的DLL报错解决方案咨询

该报错的核心原因是你引用的DLL是基于.NET Framework构建的，System.Web.HttpContext是.NET Framework独有的类型，.NET Core/.NET 5+的运行时中不存在System.Web程序集，对应的HTTP上下文能力已经迁移到Microsoft.AspNetCore.Http命名空间下，二者API不兼容，所以触发类型加载失败。

方案1：获取DLL的.NET Core/.NET 兼容版本（最推荐） #

这是稳定性最高、无遗留问题的解决方式：

• 如果你是该DLL的所有者，直接将DLL的项目迁移到.NET Standard 2.0+或者与你Web API项目匹配的.NET版本，把所有System.Web.HttpContext的引用替换为Microsoft.AspNetCore.Http.HttpContext，常见需要调整的API差异包括：
  • 用HttpContext.Request.Query替代原Request.QueryString
  • 用HttpContext.Request.Headers替代原Request.Headers
  • 用HttpContext.User替代原HttpContext.Current.User
• 如果是第三方提供的DLL，联系开发者索要适配.NET Core/.NET +的版本，或查找官方发布的对应兼容包。

方案2：用官方兼容包临时适配（仅临时救急，不推荐生产长期使用） #

如果暂时拿不到适配后的DLL，可以通过官方兼容包模拟System.Web.HttpContext实现临时兼容：

• 安装NuGet包Microsoft.AspNetCore.SystemWebAdapters，该包提供了.NET Framework中System.Web常用类型的.NET Core实现，包含HttpContext
• 如果你使用的是.NET 6+版本，在Program.cs中添加适配服务和中间件注册：

builder.Services.AddSystemWebAdapters();

// 中间件注册需要放在路由之后、端点映射之前
app.UseRouting();
app.UseSystemWebAdapters();
app.MapControllers();

• 注意：该适配包仅能覆盖大部分常用API，如果你引用的DLL用到了System.Web下的冷门API，依然可能出现运行时错误。

方案3：切换Web API项目的目标框架（最后备选） #

如果上述两个方案都不可行，且你不需要.NET Core的跨平台、高性能等特性，可以将Web API项目的目标框架修改为.NET Framework 4.x，就能原生兼容System.Web相关API，但该方案会丢失.NET Core的所有优势，仅作为无其他选择时的兜底方案。

不要尝试手动将.NET Framework的System.Web.dll引入.NET Core项目，即便编译阶段不报错，运行时也会出现大量不可预期的异常。

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