如何让.NET Framework 4.8类库兼容.NET Framework与Core REST应用？

1. 多目标框架（Multi-targeting）改造类库 #

• 将类库的.csproj文件修改为多目标配置，同时支持net48和net6.0（或更高.NET Core版本）。
• 针对System.Web的依赖，用条件编译指令区分平台处理：
  • .NET Framework环境下保留System.Web相关代码；
  • .NET Core环境下替换为ASP.NET Core的等效API，比如用Microsoft.AspNetCore.Http替代System.Web.HttpContext的功能。
• 项目文件配置示例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net48;net6.0</TargetFrameworks>
  </PropertyGroup>
  <ItemGroup Condition="'$(TargetFramework)' == 'net48'">
    <Reference Include="System.Web" />
  </ItemGroup>
  <ItemGroup Condition="'$(TargetFramework)' == 'net6.0'">
    <PackageReference Include="Microsoft.AspNetCore.Http" Version="6.0.0" />
  </ItemGroup>
</Project>

• 代码中的条件编译示例：

#if NET48
using System.Web;
#else
using Microsoft.AspNetCore.Http;
#endif

public class RetailService
{
    public string GetClientIp(object context)
    {
#if NET48
        var webContext = context as HttpContext;
        return webContext?.Request.UserHostAddress;
#else
        var coreContext = context as HttpContext;
        return coreContext?.Connection.RemoteIpAddress?.ToString();
#endif
    }
}

2. 适配器模式封装System.Web依赖 #

• 抽象出与System.Web无关的接口，把原类库中依赖System.Web的逻辑封装到适配器类里。
• 分别为.NET Framework和.NET Core实现不同的适配器：
  • .NET Framework适配器直接调用System.Web的API；
  • .NET Core适配器用ASP.NET Core的对应API实现相同功能。
• 原类库只依赖抽象接口，不直接引用System.Web，以此实现跨框架兼容。

3. .NET Standard中间层拆分 #

• 把原类库中不依赖System.Web的核心业务逻辑，提取到一个.NET Standard 2.0类库中（.NET Standard 2.0兼容.NET Framework 4.8和.NET Core 3.0+）。
• 保留原.NET Framework类库作为适配层，专门处理System.Web相关逻辑，并引用这个.NET Standard核心库。
• 新建一个.NET Core适配层类库，用ASP.NET Core API替代System.Web功能，同样引用.NET Standard核心库。
• 这种方式下核心业务逻辑只需维护一份，两个适配层各自处理平台特定依赖。

4. 进程外调用（临时过渡方案） #

• 如果上述改造难以快速落地，可以暂时把原.NET Framework类库作为独立服务运行，.NET Core API通过HTTP、gRPC或消息队列与它通信。
• 该方案无需修改原类库，但会增加架构复杂度和性能开销，仅适合短期过渡，最终仍建议逐步迁移到跨框架方案。

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