Laravel 5.5队列生成PDF报错：fopen找不到文件/目录排查求助

安全阿岳

2026-5-15

你的怀疑完全没错！这种场景下，服务提供者在CLI（队列）环境下未初始化PDF生成的关键组件/配置确实是最常见的原因之一，我来帮你拆解问题和解决办法：

为什么网页端正常，队列环境却失败？

网页端是HTTP请求上下文，Laravel会自动初始化所有和Web相关的组件（比如asset路径解析、URL生成规则），而队列任务运行在CLI环境中，很多服务提供者会通过App::runningInConsole()做条件加载——如果你的PDF相关组件刚好被放在了「仅Web环境加载」的逻辑里，队列环境下就会缺失必要的配置，导致mpdf找不到图片文件。

除此之外，还有两个常见的关联问题：

你在PDF模板里用了asset()生成的URL（比如http://your-app.com/images/logo.png），但队列环境中服务器可能无法访问这个外部URL（比如本地环境host配置问题、PHP禁用了allow_url_fopen），mpdf尝试直接读取URL对应的文件时就会失败。
CLI运行队列的用户和Web服务器用户（比如www-data）权限不同，导致无法读取图片文件的物理路径。

具体解决步骤

1. 检查服务提供者的条件加载逻辑

打开你的PDF相关服务提供者（比如PdfServiceProvider.php），看看有没有类似这样的代码：

public function register()
{
    if (!App::runningInConsole()) {
        // 仅Web环境注册PDF组件
        $this->app->singleton('pdf', function ($app) {
            return new \niklasravnsborg\LaravelPdf\Pdf;
        });
    }
}

如果有，直接移除if (!App::runningInConsole())的条件判断，确保CLI环境也能注册PDF组件。如果需要针对不同环境做配置，可以分开处理但不要完全跳过注册：

public function register()
{
    $this->app->singleton('pdf', function ($app) {
        $pdf = new \niklasravnsborg\LaravelPdf\Pdf;
        
        // 统一配置：设置临时目录、字体路径等，确保CLI环境可用
        $pdf->setTempPath(storage_path('app/temp'));
        $pdf->setFontDir(public_path('fonts'));
        
        // 可选：针对CLI环境单独调整配置
        if (App::runningInConsole()) {
            $pdf->allow_url_fopen = true; // 允许加载远程资源（如果需要）
        }
        
        return $pdf;
    });
}

2. 统一图片路径为物理路径

不要在PDF模板里使用asset()生成的URL，改用物理路径让mpdf直接读取文件：

错误写法：<img src="{{ asset('images/invoice-logo.png') }}">
正确写法：<img src="{{ public_path('images/invoice-logo.png') }}">

如果你的图片存储在storage/app/public下，用storage_path('app/public/images/logo.png')即可。

3. 确保CLI环境的URL配置正确

如果必须使用URL加载图片（比如图片在CDN上），需要在队列任务里手动设置APP_URL，避免CLI环境下URL生成异常：

// 在你的队列任务类的handle方法开头添加
config(['app.url' => env('APP_URL')]);

同时确保PHP的allow_url_fopen配置为On（可以在php.ini里设置，或者在任务里临时开启：ini_set('allow_url_fopen', 1);）。

4. 检查文件权限

确保队列运行用户（比如你本地的普通用户、服务器上的www-data）有读取图片文件的权限。可以通过执行以下命令修复权限：

chown -R www-data:www-data public/images
chmod -R 755 public/images

测试验证

修改后，你可以手动触发队列任务测试：

php artisan queue:work --once

然后检查生成的PDF是否正常显示图片，同时查看日志是否还有fopen警告。

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