.NET Framework NuGet库兼容性问题与多目标项目故障排查

现有基于VB.NET开发、运行在.NET Framework 4.6.1的Web API，计划重写为C#的.NET 8版本并部署到Azure。该应用依赖VB.NET编写、目标为.NET Framework的业务逻辑层NuGet包，调用部分方法时出现兼容性问题。已尝试的方案：

• 移植到.NET Standard：因工作量大且旧项目仍在活跃开发，已放弃
• 为业务逻辑层设置多目标框架：升级为SDK风格VB项目后，添加.NET Standard 2.0目标时出现Visual Studio版本回退异常，构建产生大量错误
• RPC/LPC方案：尚未尝试

咨询问题：

1. 多目标框架是否为正确方案？
2. 如何修复当前多目标框架方案的故障？
3. .NET 8应用能否通过少量调整引用.NET Standard 2.0 NuGet库？

1. 多目标框架是否为正确方案？ #

是，这是当前场景下最务实的方案——既能保留旧.NET Framework项目的正常开发迭代，又能让新的.NET 8应用直接兼容调用业务逻辑层，避免重复开发或引入RPC这类额外复杂度的方案。

2. 如何修复多目标框架方案的故障？ #

针对升级SDK风格VB项目后添加.NET Standard 2.0目标出现的问题，按以下步骤排查修复：

• 先解决Visual Studio版本回退异常：
  • 确保使用Visual Studio 2022（最低17.4版本），旧版本对VB SDK风格项目的多目标支持不完善，直接升级到最新稳定版VS2022
  • 清理项目的obj和bin目录，删除.vs隐藏文件夹，重新加载项目
• 修复构建错误：
  • 检查业务逻辑层中依赖.NET Framework专属API的代码（比如System.Web、Microsoft.Win32.Registry的部分方法，或者VB特定的旧语法），针对.NET Standard 2.0目标添加条件编译：

    #If NETFRAMEWORK Then
        ' .NET Framework专属代码
        Dim regKey = Microsoft.Win32.Registry.LocalMachine.OpenSubKey("SomeKey")
    #Else
        ' .NET Standard兼容的替代实现，或者如果不需要可以留空/抛出明确异常
        Throw New NotSupportedException("此方法在.NET Standard环境下不支持")
    #End If
    

  • 检查NuGet依赖：确保所有引用的包都支持.NET Standard 2.0，对于只支持.NET Framework的包，同样用条件编译引用，或者替换为兼容的包
  • 手动编辑VB项目的.vbproj文件，确保多目标配置正确，示例配置：

    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
        <TargetFrameworks>net461;netstandard2.0</TargetFrameworks>
        <RootNamespace>YourBusinessLogic</RootNamespace>
        <AssemblyName>YourBusinessLogic</AssemblyName>
        <LangVersion>16.0</LangVersion> <!-- 适配VB最新语法，根据VS版本调整 -->
      </PropertyGroup>
      <!-- .NET Framework专属引用 -->
      <ItemGroup Condition="'$(TargetFramework)' == 'net461'">
        <Reference Include="System.Web" />
      </ItemGroup>
    </Project>
    

3. .NET 8应用能否通过少量调整引用.NET Standard 2.0 NuGet库？ #

完全可以，.NET 8原生支持.NET Standard 2.0，不需要额外复杂调整：

• 直接在.NET 8项目中安装该.NET Standard 2.0的NuGet包即可
• 仅需注意：如果业务逻辑层的.NET Standard 2.0实现中存在依赖.NET Framework专属API的代码（且没有做条件编译处理），调用时会抛出运行时异常，这时候需要回到业务逻辑层的多目标项目中补全兼容实现

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