Laravel Vapor Docker运行环境中运行Puppeteer与Spatie/Browsershot异常问题求助

我之前在Laravel Vapor的Docker环境中搭配Browsershot和Puppeteer时，也碰到过几乎一模一样的连接中断问题。结合你的配置和报错信息，下面是几个可以尝试的解决方案：

1. 补充适配无服务器环境的Chromium启动参数 #

Vapor的Docker容器资源有限，默认的Chromium启动参数可能不足以稳定运行。建议补充更多针对资源受限环境的参数：

修改你的Browsershot代码，更新addChromiumArguments部分：

Browsershot::url('https://www.test-url.com')
    ->setNodeBinary(env('NODE_BINARY') ?? '/usr/bin/node')
    ->setNpmBinary(env('NPM_BINARY') ?? '/usr/bin/npm')
    ->addChromiumArguments([
        'no-sandbox',
        'disable-setuid-sandbox',
        'disable-dev-shm-usage',
        'single-process', // 单进程模式减少资源占用
        'disable-gpu', // 无服务器环境无需GPU渲染
        'no-zygote', // 跳过zygote进程初始化
        'no-first-run', // 跳过首次运行的配置步骤
        'disable-features=VizDisplayCompositor', // 禁用非必需的渲染特性
    ])
    // ... 其余代码保持不变
    ->pdf();

2. 调整网络等待策略 #

waitUntilNetworkIdle()在部分网络不稳定的环境下，可能会因为等待过严导致连接中断。可以尝试改用更宽松的等待规则，同时增加超时时间：

// 替换原有的waitUntilNetworkIdle()
->waitUntil('networkidle2') // 当500ms内仅剩余≤2个网络连接时视为就绪
->setTimeout(60000) // 设置60秒超时，可根据实际需求调整

3. 确保Node.js与Puppeteer版本兼容 #

你的Dockerfile中用apk add nodejs安装的Node版本，可能和Puppeteer@10.2.0不兼容（Puppeteer 10.x要求Node.js 14.1.0及以上版本）。建议指定安装匹配的Node版本：

修改Dockerfile中的Node安装段：

# 替换原有的nodejs/npm安装命令
RUN apk add --no-cache \
    chromium \
    nss \
    freetype \
    harfbuzz \
    ca-certificates \
    ttf-freefont \
    nodejs=14.21.3-r0 \
    npm=8.19.4-r0

可以通过apk search nodejs查看镜像内可用的Node版本，选择和Puppeteer 10.2.0适配的版本。

4. 以非root用户运行Chromium #

Chromium在root用户下运行可能存在稳定性隐患，建议在Dockerfile中创建普通用户并切换：

# 在COPY . /var/task之前添加以下内容
RUN addgroup -S pptruser && adduser -S -G pptruser pptruser \
    && mkdir -p /home/pptruser/Downloads /var/task \
    && chown -R pptruser:pptruser /home/pptruser \
    && chown -R pptruser:pptruser /var/task

USER pptruser

切换用户后，确保Browsershot中Chromium的路径配置正确。

5. 手动指定Puppeteer路径 #

有时候Browsershot无法自动识别全局安装的Puppeteer，可以手动指定其路径：

->setPuppeteerPath('/usr/lib/node_modules/puppeteer')

这个路径是全局安装Puppeteer后的默认位置，可根据实际安装情况调整。

如果以上方案都无法解决问题，可以开启Browsershot的调试模式，获取更详细的错误日志：

->setDebug(true)

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