安装NuGet包导致.NET Framework下ASP.NET应用服务器错误

获取详细加载异常信息 #

默认错误提示未提供具体失败原因，需捕获LoaderExceptions的详细内容：

• 打开项目的Global.asax.vb，在Application_Error事件中添加以下代码：

Sub Application_Error(ByVal sender As Object, ByVal e As EventArgs)
    Dim currentEx As Exception = Server.GetLastError()
    If TypeOf currentEx Is ReflectionTypeLoadException Then
        Dim loadException As ReflectionTypeLoadException = DirectCast(currentEx, ReflectionTypeLoadException)
        Dim errorDetails As New StringBuilder()
        For Each ex In loadException.LoaderExceptions
            errorDetails.AppendLine($"错误信息：{ex.Message}")
            If ex.InnerException IsNot Nothing Then
                errorDetails.AppendLine($"内部异常：{ex.InnerException.Message}")
            End If
            errorDetails.AppendLine("---")
        Next
        Server.ClearError()
        Response.Write($"<pre>{errorDetails.ToString()}</pre>")
    End If
End Sub

• 重新运行站点，页面将显示所有加载失败的具体原因，包括版本冲突、缺失依赖等关键信息。

追踪程序集绑定过程 #

使用.NET Framework自带的**程序集绑定日志查看器（Fuslogvw.exe）**定位冲突：

1. 以管理员身份打开Visual Studio开发者命令提示符，执行fuslogvw.exe启动工具。
2. 点击「设置」，选择「记录所有程序集绑定失败」，指定日志输出目录（确保目录有写入权限）。
3. 触发站点加载错误后，回到工具点击「刷新」，找到对应失败的程序集条目，查看详细日志：日志会显示程序集尝试加载的版本、从何处加载（GAC/本地bin目录）以及失败原因。

解决GAC与NuGet包的版本冲突 #

若日志显示GAC中的程序集版本与NuGet安装版本不一致，可通过绑定重定向强制使用NuGet版本：

• 在项目的web.config中添加以下配置（以System.Runtime.CompilerServices.Unsafe为例，其他冲突程序集可依此类推）：

<runtime>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
      <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-5.0.0.0" newVersion="5.0.0.0" />
    </dependentAssembly>
  </assemblyBinding>
</runtime>

• 确认项目属性的「生成」选项卡中，「自动生成绑定重定向」已勾选，确保NuGet安装时自动添加必要的重定向配置。

验证依赖包兼容性与降级测试 #

• 检查每个依赖包的官方兼容性说明，确认其支持.NET Framework 4.6.2。例如System.Runtime.CompilerServices.Unsafe 5.0.0虽支持4.6.2，但部分环境可能需额外配置。
• 尝试将Microsoft.ApplicationInsights降级至2.20.0等稍旧版本，新版本可能引入对更高版本依赖的隐性要求，导致加载冲突。

检查输出目录程序集完整性 #

• 清理项目的bin和obj目录后重新生成，查看bin目录下是否存在所有依赖程序集，且版本与NuGet安装的一致。
• 若缺失某个程序集，可从本地NuGet包目录（默认路径%userprofile%\.nuget\packages）复制对应版本的程序集到bin目录。

内容的提问来源于stack exchange，提问作者Ben C.