SelectPDF发布到服务器后HTML转PDF慢 偶发导航超时500报错

本地localhost环境转换功能正常、单次耗时稳定在5秒内，部署到服务器后偶发返回Conversion error: Navigation timeout错误，不需要将最大加载时间设置为2分钟，问题本质和HTML内容复杂度无关，是默认配置和部署环境的兼容问题，按以下优先级调整即可，转换速度可保持和本地测试一致：

1. 掐断所有不必要的外部资源请求 #

80%以上的偶发超时都是渲染内核等待无响应的外部资源导致的：

• 调用ConvertHtmlString传入HTML字符串时，渲染内核默认会自动解析HTML内的相对路径资源（CSS、JS、图片、字体文件），如果服务器出网受限、DNS解析偶发失败、请求被防火墙拦截，内核会持续等待资源响应直到触发超时。
• 优先将所有静态资源内联处理：CSS直接写入页面<style>标签，小体积图片转base64格式嵌入，不需要前端交互的场景直接删除所有<script>标签，从根源上消除外部资源请求。
• 显式配置转换器参数，关闭非必要渲染能力：

var converter = new HtmlToPdf();
// 禁用JS执行，静态PDF转换不需要运行前端脚本
converter.Options.JavaScriptEnabled = false;
// 使用打印样式表渲染，避免加载屏幕适配的冗余资源
converter.Options.CssMediaType = SelectPdf.CssMediaType.Print;
// 确需加载外部资源时，显式配置站点根路径，不要让内核自行解析相对路径
converter.Options.BaseUrl = "https://你的站点绝对根地址/";
// 单独设置导航超时为15秒即可，无需拉满到120秒，仅给系统调度波动留足够余量
converter.Options.NavigationTimeout = 15;

2. 修复部署环境权限与实例复用问题 #

剩余20%的偶发超时基本是环境配置错误导致的：

• 不要全局单例复用HtmlToPdf实例，每次转换都新建实例，转换完成后除了调用doc.Close()，也要调用converter.Dispose()释放渲染内核进程；高并发场景下复用实例会导致内核进程锁死，直接阻塞到超时。
• 给站点应用池的运行身份，授予系统临时目录（默认路径C:\Windows\Temp）的读写权限。SelectPDF渲染时会在临时目录写入缓存文件，权限不足时不会直接抛出权限错误，会卡在渲染启动阶段最终报导航超时。
• 将SelectPDF包内自带的webkit渲染内核进程，加入服务器杀毒软件/安全防护的白名单，避免安全软件偶发扫描拦截进程启动导致的卡顿。

3. 额外优化配置 #

• 不需要渲染图片的场景可以开启converter.Options.SkipImages = true进一步压缩转换时间
• 需要保留脚本的场景开启converter.Options.StopSlowScripts = true，避免异常脚本阻塞渲染流程

按以上配置调整后，简单HTML的转换耗时依然可以稳定在5秒以内，不会出现需要等待2分钟的情况，偶发导航超时问题可完全解决。

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