ASP.NET Core Web API多目标框架配置：兼容3.1与6.0版本

完全可以通过设置多目标框架来实现，思路和类库多目标配置一致，不过Web API项目需要注意一些框架差异的兼容处理，具体步骤如下：

1. 修改项目文件配置 #

打开你的Web API项目的.csproj文件，将原来的单个目标框架配置：

<TargetFramework>netcoreapp3.1</TargetFramework>

替换为多目标框架配置：

<TargetFrameworks>netcoreapp3.1;net6.0</TargetFrameworks>

2. 处理框架专属代码差异 #

如果你的API中使用了.NET 6专属特性（比如最小API写法、新的Results类型、顶级语句等），需要用条件编译指令区分不同框架的代码逻辑：

#if NET6_0
// .NET 6专属代码，比如最小API路由
app.MapGet("/api/hello", () => Results.Ok("Hello from .NET 6"));
#else
// .NET Core 3.1兼容代码，使用传统Startup配置
app.UseEndpoints(endpoints =>
{
    endpoints.MapGet("/api/hello", context => context.Response.WriteAsync("Hello from .NET Core 3.1"));
});
#endif

如果项目原本是.NET Core 3.1的Startup结构，在.NET 6中可以保留该结构，无需强制切换到顶级语句，这样能减少兼容成本。

3. 适配NuGet依赖项 #

确保项目引用的NuGet包同时兼容两个目标框架，对于版本差异较大的依赖，可以使用条件引用：

<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.2.0" Condition="'$(TargetFramework)' == 'netcoreapp3.1'" />
<PackageReference Include="Microsoft.AspNetCore.Mvc.Core" Version="6.0.0" Condition="'$(TargetFramework)' == 'net6.0'" />

优先选择同时支持两个框架的包版本，避免不必要的条件引用。

4. 生成多版本包 #

执行dotnet pack命令后，工具会自动为每个目标框架生成独立的NuGet包，包文件名会包含对应的框架标识，例如：

• YourWebApi.1.0.0.netcoreapp3.1.nupkg
• YourWebApi.1.0.0.net6.0.nupkg

注意事项 #

• 启动逻辑兼容：如果混用了.NET 6的顶级语句和.NET Core 3.1的Startup类，务必通过条件编译确保每个框架下的启动逻辑正确。
• 测试验证：打包完成后，分别在安装了.NET Core 3.1和.NET 6的服务器上部署测试，确认功能正常。
• 依赖检查：避免引用仅支持单一框架的NuGet包，否则会导致对应框架的打包失败。

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