如何在IIS部署的.NET Core API中管理wkhtmltopdf，解决高并发下进程卡死问题

你遇到的报错是wkhtmltopdf依赖的Qt框架在高并发场景下耗尽Windows系统用户态资源导致的：

• 每个wkhtmltopdf进程启动时都会创建Qt内部的消息窗口、注册系统GetMessage钩子，短时间并发过高时，系统分配给当前用户会话的USER对象、窗口句柄、钩子资源不足，就会抛出该错误
• 部分卡死的wkhtmltopdf进程没有正常退出，会持续占用系统资源，进一步加剧资源耗尽的情况

1. 限制并发数，引入进程池/队列机制 #

这是最高效的解决方式，从根源上避免短时间创建大量wkhtmltopdf进程：

• 不要让每个请求直接启动新的wkhtmltopdf进程，改为用固定大小的进程池复用wkhtmltopdf实例，Windows场景下建议进程池大小设置为CPU核心数的1~2倍即可
• 如果不想自行实现进程池，可以引入异步任务队列，所有PDF生成请求先入队，后台用固定数量的worker消费队列执行生成任务，超过队列长度的请求可以返回重试提示或者放入延迟队列
• 可以替换RotativaCore为DinkToPdf库，这个库支持封装wkhtmltox的动态库调用，不需要每次创建独立进程，并发性能提升非常明显，只需要项目引入对应版本的wkhtmltox.dll即可

2. 优化wkhtmltopdf调用参数 #

调整启动参数减少资源占用：

• 启动时添加--disable-javascript参数，如果你不需要PDF里运行JS的话，可以大幅降低单个进程的资源占用和运行时长
• 添加--no-stop-slow-scripts参数避免JS执行超时报错卡死，也可以加--javascript-delay <毫秒数>固定JS等待时长，减少进程挂死概率
• 强制启用无界面模式：添加--qt-headless参数（部分旧版本wkhtmltopdf需要用--headless），减少Qt对UI相关资源的占用

3. 增加进程异常回收机制 #

避免卡死进程长期占用资源：

• 给每个wkhtmltopdf进程设置超时时间，比如设置30秒超时，超时后直接强制Kill进程，释放占用的系统资源
• 定时巡检系统中的wkhtmltopdf进程，启动时间超过阈值的直接强制结束
• 调用进程时确保正确处置StandardOutput、StandardError流，如果流缓冲区满了进程会直接挂死，RotativaCore内部已经做了相关处理，但如果是自己封装的调用逻辑需要注意这一点

4. 系统层面优化（可选） #

如果是Windows Server部署，可以调整系统资源限制：

• 打开注册表编辑器，定位到HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Windows，调整USERProcessHandleQuota的值，默认是10000，可以调到20000甚至更高，提升单个进程可占用的USER对象上限
• 调整IIS应用程序池的标识为LocalSystem，或者给应用池标识分配"允许与桌面交互"的权限，避免会话资源限制
• 不要用IIS的共享应用程序池，单独给这个API项目分配独立的应用程序池，避免其他项目占用资源

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