Laravel队列中Browsershot运行失败求助（Docker环境）

核心原因 #

同步调用dispatchSync在Web容器内执行，该容器已安装Chromium；但异步队列任务由Worker容器执行，Worker容器缺少Chromium或相关依赖，导致找不到指定路径的浏览器进程。

解决方案 #

1. 确保Worker容器安装了Chromium及依赖 #

修改Worker容器的Dockerfile，添加Chromium安装命令：

# 基于Debian/Ubuntu镜像的示例
RUN apt-get update && apt-get install -y \
    chromium-browser \
    libnss3-dev \
    libgdk-pixbuf2.0-dev \
    libgtk-3-dev \
    libxss-dev \
    fonts-liberation \
    libasound2 \
    libatk-bridge2.0-0 \
    libdrm2 \
    libxkbcommon0 \
    libgbm1

构建并重启Worker容器后，进入容器执行which chromium-browser，确认输出/usr/bin/chromium-browser。

2. 显式指定Chromium路径 #

如果Worker容器中Chromium的安装路径与Web容器不同，在Browsershot调用时强制指定路径：

use Spatie\Browsershot\Browsershot;

// 异步任务类中的示例代码
public function handle()
{
    Browsershot::html('<h1>Test Content</h1>')
        ->setChromePath('/usr/bin/chromium-browser') // 替换为Worker容器内的实际路径
        ->save(storage_path('app/screenshot.png'));
}

3. 验证Worker容器的无头浏览器环境 #

进入Worker容器，直接执行Chromium无头模式命令测试：

chromium-browser --headless=new --disable-gpu --no-sandbox --dump-dom https://example.com

如果能正常输出页面DOM，说明环境配置正确；若报错，根据提示补充缺失的依赖。

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