Puppeteer Headless模式HTML转PDF的性能参数配置与内存限制方案

推荐保留的启动参数（最低CPU/内存占用配置） #

针对纯HTML转PDF的无交互场景，你给出的新增参数里仅需保留以下和场景强相关的配置，其余可直接删除：

• --disable-notifications：禁用系统通知相关服务，减少不必要的事件监听开销
• --disable-translate：关闭自动翻译组件及弹窗逻辑，无交互场景完全无用
• --safebrowsing-disable-auto-update：禁用安全浏览组件后台更新逻辑，避免额外资源占用
• --disable-setuid-sandbox、--no-sandbox、--no-zygote：关闭沙箱相关安全机制，服务器自用场景下可大幅降低进程启动开销和内存占用，若为公开可调用的服务可根据安全评估决定是否保留沙箱
• --disable-gpu：HTML转PDF不需要GPU渲染能力，关闭后可直接省掉GPU进程的所有内存和CPU开销
• --hide-scrollbars：避免滚动条占用渲染空间，同时减少滚动相关的渲染计算逻辑
• --autoplay-policy=no-user-gesture-required：若HTML包含音视频内容，可保证内容正常加载不卡进程，无音视频场景也不会产生额外开销
• --disable-logging：关闭所有日志输出，减少磁盘IO和CPU占用
• --disable-permissions-api：禁用权限查询相关接口，无交互场景不需要
• --disable-databases：禁用本地存储、IndexedDB等持久化存储能力，转PDF不需要数据持久化，可减少内存占用
• --ignore-certificate-errors、--ignore-ssl-errors：若需要加载HTTPS来源的HTML内容，可忽略证书校验错误避免加载失败，同时减少证书校验的额外开销
• --mute-audio：禁用音频输出相关组件，减少内存占用
• --run-all-compositor-stages-before-draw：保证页面所有渲染阶段执行完成后再生成PDF，避免内容缺失同时减少重复渲染开销
• --no-default-browser-check：跳过默认浏览器检查逻辑，加快进程启动速度

以下参数可直接删除，无任何作用甚至会产生额外开销：

• --remote-debugging-port=9222：仅调试场景需要，正常使用会额外占用端口，存在安全风险
• --user-agent=true：参数格式错误，无实际作用，反而可能导致UA识别异常
• --ignore-certificate-errors-spki-list：需要搭配具体的SPKI哈希值使用，无配置的情况下完全无效

C#端Chromium内存限制方案 #

如果参数优化后内存占用仍不符合预期，可通过以下方式实现进程级管控：

1. 系统级资源限制
   启动Chromium后通过Process类获取对应进程ID，根据运行环境选择限制方式：
   • Windows环境：调用Windows API创建Job对象，将Chromium进程绑定到Job上，设置Job的最大内存阈值，超出阈值后进程会被自动回收
   • Linux环境：操作cgroup配置，将Chromium进程ID写入对应cgroup的tasks列表，通过memory.limit_in_bytes参数设置最大内存上限
2. 进程池复用+定期销毁
   不要每次转PDF都新建Browser实例，维护固定大小的Browser进程池复用实例，每处理10~20个转换任务就主动销毁旧实例、启动新实例，避免Chromium长时间运行导致内存泄漏堆积。每次转换完成后要及时调用Page.Dispose()、Browser.Dispose()释放资源，避免僵尸进程残留。
3. PDF渲染参数优化
   调用Page.PdfAsync()方法时，可根据需求关闭不必要的渲染项：不需要打印背景时设置PrintBackground = false，优先使用HTML定义的页面尺寸设置PreferCSSPageSize = true，减少不必要的渲染计算开销。

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