VB.NET 64位项目经WixToolset分发iText7应用出现未知PDFException错误求助

问题背景 #

在64位VB.NET（.NET Framework 4.8）项目中，通过NuGet安装iText7后，VS2022调试模式下PDF保存功能正常。使用WixToolset 4.0制作安装包，安装完成后C:\Program Files\目录下可见程序exe及以下DLL，但运行时抛出"unknown PDFException"错误：

iText.Kernel.dll 
iText.Layout.dll 
iText.IO.dll 
iText.Pdfa.dll 
itext.bouncy-castle-connector.dll 
iText.commons.dll 
itext.bouncy-castle-adapter.dll 
itext.bouncy-castle-fips-adapter.dll

排查步骤 #

• 核对DLL版本一致性
  确认安装包中分发的DLL版本和NuGet安装的完全匹配，调试时用的是NuGet包的特定版本，手动复制DLL时很容易出现版本不兼容，尤其是bouncy castle相关组件，版本差异会直接触发异常。右键对比调试目录与安装目录下的DLL版本号，确保主版本、次版本、修订号完全一致。

• 验证DLL架构兼容性
  项目是64位，需确认所有分发的DLL都是x64版本。部分NuGet包包含多架构版本，Wix打包时若误选x86版本，会导致64位程序加载失败触发异常。可使用dumpbin /headers [DLL路径]命令查看DLL目标架构，确认是x64而非x86。

• 检查依赖项是否缺失
  iText7的依赖可能不止列出的这些，比如bouncy castle核心组件（BouncyCastle.Crypto.dll、BouncyCastle.Security.dll等），调试时这些依赖会被自动复制到输出目录，但Wix打包时容易遗漏。用Dependency Walker或VS依赖项分析工具扫描安装目录下的exe，排查是否有缺失的依赖。

• 捕获详细异常信息
  "unknown PDFException"属于泛化错误，建议在程序中添加全局异常捕获，输出InnerException和StackTrace定位具体原因（比如字体缺失、权限不足、组件初始化失败等）。示例VB.NET代码：

  AddHandler AppDomain.CurrentDomain.UnhandledException, AddressOf CurrentDomain_UnhandledException
  
  Private Sub CurrentDomain_UnhandledException(sender As Object, e As UnhandledExceptionEventArgs)
      Dim ex As Exception = DirectCast(e.ExceptionObject, Exception)
      File.WriteAllText("error.log", $"Message: {ex.Message}{Environment.NewLine}InnerException: {ex.InnerException?.Message}{Environment.NewLine}StackTrace: {ex.StackTrace}")
  End Sub
  

  运行安装后的程序，查看生成的error.log获取具体错误线索。

• 排查运行权限问题
  C:\Program Files\属于系统保护目录，程序在此目录下生成临时文件或保存PDF时可能因权限不足触发异常。可将程序复制到非系统保护目录（如D:\Test）运行，验证是否为权限问题。

• 检查Wix打包规则
  确认Wix项目中是否正确包含所有依赖DLL，尽量通过引用项目输出或NuGet包输出目录的方式打包，避免手动选择文件遗漏依赖。比如用Heat.exe生成项目输出的组件，自动包含所有必要文件。

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