.NET Core应用替换旧版本DLL为何触发运行时错误？

• 核心差异：.NET Core 与 .NET Framework 的加载逻辑
  .NET Framework 对同一目录下的未签名私有程序集，默认采用宽松的版本策略——只要文件存在，无论版本是否匹配编译时引用的版本，都会直接加载。但 .NET Core 5+（含.NET7）的程序集加载器设计更严谨，默认会严格校验EXE元数据中记录的依赖版本：哪怕DLL和EXE在同一目录、未签名，只要部署的DLL版本低于EXE编译时引用的版本，就会触发加载错误。

• 你忽略的关键细节

  1. 版本元数据硬编码：EXE编译完成后，其程序集元数据会明确记录编译时依赖的DLL版本号，.NET Core加载器会以此为校验基准，不会像.NET Framework那样自动忽略版本差异。
  2. 自动绑定重定向的缺失：.NET Framework默认会为未签名程序集自动生成绑定重定向规则，兼容版本差异；但.NET Core默认关闭了这一特性，且不会为未签名程序集自动适配版本。

• 可行的解决办法

  • 同步更新DLL（推荐）
    部署时同时替换EXE和对应版本的DLL，保持依赖版本与编译时一致，这是最符合.NET Core依赖管理设计的方案，能避免潜在的兼容性风险。
  • 手动配置绑定重定向
    在EXE的YourAppName.runtimeconfig.json文件中添加版本重定向规则，允许加载器接受指定版本范围内的DLL：

    {
      "runtimeOptions": {
        "assemblyBinding": {
          "dependencies": [
            {
              "name": "YourTargetDll",
              "publicKeyToken": null,
              "culture": "",
              "bindingRedirects": [
                {
                  "oldVersion": "0.0.0.0-2.0.0.0",
                  "newVersion": "1.0.0.0"
                }
              ]
            }
          ]
        }
      }
    }
    

    替换YourTargetDll为你的DLL名称，oldVersion覆盖EXE引用的版本范围，newVersion设为当前部署的DLL版本即可。
  • 临时禁用版本校验（不推荐）
    设置环境变量DOTNET_IGNORE_VERSIONING=true可强制加载器跳过版本校验，但这会绕过.NET Core的依赖安全机制，可能引发未知问题，仅适合临时测试场景。

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