部署IIS时iText 7 HTML转PDF出现空引用异常问题

可能原因及对应解决方法 #

1. 依赖包未完整部署 #

开发环境中NuGet会自动管理依赖，但IIS部署时常出现附属包缺失的情况：

• 检查发布目录，确认itext.html2pdf、itext.kernel、itext.layout、itext.html2pdf.css等所有iText相关dll都存在。
• 右键项目→管理NuGet程序包→已安装，选中所有iText类包，将复制本地属性设为True，确保部署时自动复制所有依赖文件。

2. BaseUri路径与权限问题 #

代码中硬编码路径分隔符或权限不足会导致资源加载失败，间接触发空引用：

• 改用Path.Combine拼接路径，避免系统兼容性问题：

string baseUri = Path.Combine(_env.ContentRootPath, "assets");

• 给IIS应用程序池身份添加assets目录的读取权限，确保程序能访问该目录下的资源。

3. 字体加载异常 #

BrTagWorker的空引用常间接来自字体加载失败（iText处理换行依赖字体配置）：

• 在ConverterProperties中显式配置字体提供者，避免依赖系统字体：

FontProvider fontProvider = new FontProvider();
// 替换为实际字体文件路径
fontProvider.AddFont(Path.Combine(baseUri, "fonts/your-font.ttf"));
prop.SetFontProvider(fontProvider);

• 确认字体文件已部署到对应目录，且应用池身份有读取权限。

4. 版本兼容性问题 #

itext7与itext7.pdfhtml版本不匹配会引发诡异的空引用：

• 在NuGet中统一所有iText相关包的版本，确保主包和插件包版本完全一致，优先选择稳定版。

5. 临时目录权限不足 #

iText转换PDF时需要读写临时文件，权限不足会触发异常：

• 给应用池身份（如IIS AppPool\你的应用池名称）授予系统临时目录（C:\Windows\Temp）的读写权限；或自定义临时目录并配置权限：

string tempDir = Path.Combine(_env.ContentRootPath, "temp");
Directory.CreateDirectory(tempDir); // 确保目录存在
prop.SetTempDirectory(tempDir);

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