Laravel本地domPDF无法生成PDF，线上正常，超时问题求助

我之前在本地开发Laravel项目时，也碰到过和你一模一样的domPDF超时问题——线上运行正常，本地却一直报Maximum execution time of 60 seconds exceeded，哪怕改了执行时间也没用。结合你的代码和场景，给你几个实用的排查方向和解决办法：

1. 确认PHP执行时间配置真的生效了 #

有时候我们改了php.ini里的max_execution_time，但要么没重启本地服务器（比如XAMPP/WAMP），要么项目里的.htaccess或user.ini文件覆盖了这个配置。

你可以在控制器代码里临时加一行，看看实际生效的执行时间：

public function downloadPDF($id){
    echo ini_get('max_execution_time'); // 输出当前生效的执行时间
    die();
    // 原有代码...
}

如果输出还是60，那说明你的配置没生效，得找到真正生效的配置文件修改后重启服务器。也可以在代码里临时设置更长的时间测试：

set_time_limit(120); // 把执行时间临时设为120秒

2. 排查本地视图里的资源加载问题 #

domPDF渲染PDF时，对HTML/CSS的兼容性、资源加载很敏感，本地环境经常因为这个卡住：

• 检查远程资源：如果你的reports.invoice视图里有远程图片、字体链接，本地网络访问这些资源慢或者访问不到，会导致domPDF一直等待超时。建议把远程资源换成本地绝对路径，或者用base64嵌入图片。
• 简化视图测试：先把视图改成最极简的内容（比如只显示{{ $invoice->stu_name }}），如果能正常生成PDF，再逐步加回原来的HTML/CSS，找到是哪个元素（比如复杂的表格、自定义字体）导致的超时。

3. 优化domPDF的配置选项 #

试试给domPDF加几个优化配置，提升本地渲染性能：

public function downloadPDF($id){
    set_time_limit(120);
    $invoice = Student::join('admission_details','admission_details.ad_student','=','students.stu_id')
        ->where('stu_id',$id)
        ->first();
    
    $pdf = PDF::loadView('reports.invoice', compact('invoice'))
        ->setPaper('a4')
        ->setWarnings(false)
        ->setOptions([
            'isRemoteEnabled' => false, // 禁用远程资源加载，避免卡住
            'chroot' => public_path(), // 限制domPDF只能访问public目录，提升安全性和速度
            'fontCache' => storage_path('app/dompdf/cache'), // 指定字体缓存目录，避免重复加载
        ]);
    
    return $pdf->download('Fee-Structure.pdf');
}

另外，domPDF第一次渲染时会缓存字体，你可以把线上服务器的storage/app/dompdf/cache目录复制到本地，跳过第一次字体加载的耗时。

4. 优化数据库查询 #

你的查询语句虽然简单，但如果本地数据库里的数据量较大，或者stu_id、ad_student字段没有加索引，也可能拖慢整个流程：

// 给students.stu_id和admission_details.ad_student加索引
// 可以在迁移文件里加，或者直接在数据库里手动创建

也可以在控制器里打印查询耗时，确认是不是查询的问题：

DB::enableQueryLog();
$invoice = Student::join('admission_details','admission_details.ad_student','=','students.stu_id')
    ->where('stu_id',$id)
    ->first();
dd(DB::getQueryLog()); // 查看查询耗时

5. 检查本地环境资源 #

本地机器的CPU、内存性能不如线上服务器，domPDF渲染复杂PDF时会占用较多资源。你可以关闭本地其他占用资源的程序，或者尝试用更轻量的视图内容测试。

如果以上方法都试过还是不行，可以尝试更新domPDF到最新版本，或者切换到barryvdh/laravel-snappy（基于wkhtmltopdf的包），不过domPDF还是更适合轻量场景。

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