1. IronPDF
  2. 故障排除
  3. 在.NET Framework中版本升级后程序集不匹配

.NET Framework版本升级后的程序集不匹配

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

在.NET Framework项目中升级IronPDF后，应用程序在运行时抛出此异常：

System.IO.FileLoadException: Could not load file or assembly 'IronPdf, Version=X.Y.Z.W,
Culture=neutral, PublicKeyToken=...' or one of its dependencies. The located assembly's
manifest definition does not match the assembly reference.
(Exception from HRESULT: 0x80131040)

NuGet包升级会安装新的程序集版本，但旧版本仍然缓存于项目的runtimes输出目录中。 .NET Framework在查找NuGet缓存前会从这些本地文件夹中解析程序集，因此陈旧的缓存DLL与新安装的包冲突，导致绑定失败。

解决方案

步骤 1：使用Visual Studio中的NuGet包管理器（工具 > NuGet包管理器 > 管理解决方案的NuGet包）卸载IronPDF和所有与Iron相关的包（如IronPdf.Native.Chrome.Windows）。

步骤 2：从项目输出目录中删除bin/Release）文件夹。

步骤3：通过NuGet包管理器重新安装IronPDF。

如果Visual Studio的清理不足，通过命令行清除全局NuGet缓存并强制进行一次清洁恢复：

dotnet nuget locals all --clear
dotnet restore --force
dotnet nuget locals all --clear
dotnet restore --force
SHELL

对于服务器部署：在重新发布之前，从服务器目录中删除所有旧的IronPDF DLL。 部署到新的目录，并更新IIS以指向新位置，而不是覆盖现有文件。

另请参见：IronPDF程序集版本不匹配异常参考和NuGet包部署失败。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 20,088,359 | 版本: 2026.7 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronPdf
运行示例看着你的HTML代码变成PDF文件。