.NET 3.1项目引用.NET 7生成的DLL编译失败，该如何解决？

你遇到的是跨.NET版本组件依赖冲突问题：.NET 7生成的DLL依赖System.Runtime 7.0.0.0，但.NET 3.1项目自带的是System.Runtime 4.2.2.0，版本不匹配导致编译失败。以下是具体解决思路：

核心解决步骤 #

1. 配置程序集绑定重定向 #

在.NET 3.1项目的App.config（Web项目为Web.config）中添加绑定重定向规则，让编译器把对高版本System.Runtime的请求重定向到项目已有的版本：

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="System.Runtime" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
        <!-- 把所有旧版本请求重定向到项目使用的4.2.2.0 -->
        <bindingRedirect oldVersion="0.0.0.0-7.0.0.0" newVersion="4.2.2.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

注意：这个方法生效的前提是，.NET 7 DLL用到的System.Runtime API在4.2.2.0版本中存在且兼容。如果DLL用了.NET 7独有的API，重定向后运行时还是会报错。

2. 检查DLL的API兼容性 #

如果重定向后仍然报错，需要确认.NET 7 DLL是否使用了.NET 3.1不支持的API：

• 用ILDasm或dnSpy等工具打开DLL，查看它引用的命名空间和方法，对比.NET 3.1的API文档，排查是否有.NET 7专属API。
• 如果存在专属API，这种情况下绑定重定向无法解决问题，只能二选一：
  • 把.NET 7项目的目标框架改为.NET Standard 2.0（.NET 7支持编译到该标准），重新生成兼容.NET 3.1的DLL；
  • 把.NET 3.1项目升级到.NET 7。

3. 关于更新System.Runtime的问题 #

不要尝试单独更新.NET 3.1项目中的System.Runtime到7.0版本：.NET 3.1的核心组件是与框架绑定的，跨大版本更新单个组件会引发更多兼容性问题，甚至导致项目无法运行。

最优方案（如果能修改DLL源码） #

如果有权限修改.NET 7项目的代码，直接将其目标框架改为.NET Standard 2.0，重新编译生成DLL。.NET Standard 2.0是.NET 3.1和.NET 7都支持的通用标准，能从根源上避免版本冲突问题。

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