Linux环境下Snappy PDF打印PDF报错：配置适配问题求助

我来帮你排查这个在Ubuntu上Laravel Snappy配置失效的问题，大概率是权限、二进制文件完整性或者系统依赖的问题，咱们一步步来解决：

1. 先验证wkhtmltopdf二进制文件本身是否可用 #

不管你用的是系统安装的还是vendor包里的，先在服务器终端直接执行二进制文件，确认它能正常运行：

• 如果是系统路径的：

  /usr/local/bin/wkhtmltopdf-amd64 --version
  

• 如果是h4cc vendor包的：

  cd vendor/h4cc/wkhtmltopdf-amd64/bin/
  ./wkhtmltopdf-amd64 --version
  

如果执行后报错（比如Permission denied、No such file or directory或者提示缺少库），那问题就出在二进制文件本身，先解决这个：

• 要是提示权限不足，先加执行权限：sudo chmod +x 你的二进制文件路径
• 要是提示缺少文件，可能是下载的架构不对（比如你是32位系统下了amd64的包），或者文件损坏，重新下载对应的包

2. 确保Web服务器用户有访问权限 #

Ubuntu上运行Laravel的web服务器用户一般是www-data，你需要确保这个用户能读取并执行wkhtmltopdf文件：

• 给二进制文件加全局执行权限：

  sudo chmod +x /usr/local/bin/wkhtmltopdf-amd64
  

• 如果是vendor里的文件，还要确保web用户能访问vendor目录：

  sudo chown -R www-data:www-data vendor/h4cc/wkhtmltopdf-amd64/
  sudo chmod -R 755 vendor/h4cc/wkhtmltopdf-amd64/
  

3. 修正配置文件的写法 #

Linux下不需要像Windows那样给路径加引号，直接写绝对路径即可，正确的配置示例：

系统安装的wkhtmltopdf配置 #

return [
    'pdf' => [
        'enabled' => true,
        'binary' => '/usr/local/bin/wkhtmltopdf-amd64',
        'options' => [],
    ],
    'image' => [
        'enabled' => true,
        'binary' => '/usr/local/bin/wkhtmltoimage-amd64',
        'options' => [],
    ],
];

使用h4cc vendor包的配置 #

return [
    'pdf' => [
        'enabled' => true,
        'binary' => base_path('vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64'),
        'options' => [],
    ],
    'image' => [
        'enabled' => true,
        'binary' => base_path('vendor/h4cc/wkhtmltoimage-amd64/bin/wkhtmltoimage-amd64'),
        'options' => [],
    ],
];

注意：如果用base_path()，可以先在Laravel里用dd(base_path('vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64'))输出实际路径，复制到终端测试是否正确

4. 安装wkhtmltopdf依赖的系统库 #

wkhtmltopdf依赖一些图形渲染的系统库，Ubuntu默认可能没装，执行以下命令安装：

sudo apt-get update && sudo apt-get install libxrender1 libxext6 libfontconfig1 libjpeg-turbo8

安装完成后再测试二进制文件和Laravel的调用

5. 测试Laravel中的调用 #

写个简单的测试路由来验证配置是否生效：

Route::get('/test-snappy', function () {
    try {
        $pdf = \PDF::loadView('welcome');
        return $pdf->download('test.pdf');
    } catch (\Exception $e) {
        dd($e->getMessage());
    }
});

访问这个路由，如果报错，根据错误信息进一步排查（比如权限问题会明确提示，依赖问题会说明缺少哪个库）

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