Laravel使用Barryvdh\DomPDF导出PDF报执行时间超60秒错误如何解决

一、调整最大执行时间的方案 #

• 临时单请求调整：在导出方法最开头加入PHP配置代码，仅对当前导出请求生效，不会影响其他业务

// 调整最大执行时间为120秒，可根据实际内容大小上调，设置为0表示不限制（不推荐生产环境使用）
ini_set('max_execution_time', 120);
// 同步调整内存限制，避免同时出现内存不足错误
ini_set('memory_limit', '256M');

• 全局配置调整：修改php.ini配置文件中的max_execution_time参数，调整为需要的数值后重启PHP服务即可。如果使用Nginx+PHP-FPM架构，还需要同步调整php-fpm.conf中的request_terminate_timeout，以及Nginx站点配置中的fastcgi_read_timeout参数，避免服务端提前中断请求。

二、DomPDF导出超时的其他优化建议 #

Barryvdh\DomPDF本身是基于PHP实现的PDF渲染器，对复杂HTML、外部资源的处理性能较低，可通过以下方式优化速度：

1. 优化模板内容：你的模板中{!! $singleMateri->isi !!}输出的富文本如果包含大量外链图片、复杂样式，会大幅拉长渲染时间。建议将所有图片转为base64内嵌到HTML中，避免额外的HTTP请求拉取资源；同时尽量避免使用flex、grid等现代CSS布局，改用传统的table、块级元素布局，降低DomPDF的解析成本。
2. 优化扩展配置：执行php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"发布DomPDF的配置文件，修改config/dompdf.php中的参数：开启远程资源加载权限、调整渲染后端为CPDF（比默认的PDFLib更快）、调高内存限制参数。
3. 优化导出逻辑：如果单条内容体积过大，可以先将生成的PDF存储到本地磁盘，再返回下载响应，减少请求持续时间避免超时。

三、更稳定的Laravel PDF导出方案 #

如果DomPDF始终无法满足性能要求，可以换用成熟度更高、性能更好的导出方案：

• Laravel Snappy：基于wkhtmltopdf内核，使用WebKit引擎渲染HTML，对CSS/HTML的支持度远高于DomPDF，渲染速度提升数倍，适合大多数业务场景的PDF导出需求。
• Browsershot：基于Chrome无头浏览器渲染，渲染效果和本地浏览器完全一致，支持JS交互、现代CSS特性，适合样式复杂、包含前端动态内容的页面导出，性能比DomPDF高很多。
• Laravel Excel：如果导出内容以表格、结构化数据为主，可以选用该扩展导出PDF格式，基于PhpSpreadsheet实现，处理结构化数据的效率更高。

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