Laravel中HeadlessChromium线上报错求助：Chrome进程未完成启动

问题描述 #

在Laravel项目中使用chrome-php/chrome包（通过composer require chrome-php/chrome安装），本地运行以下代码正常，但部署到线上服务器时出现错误：Chrome process stopped before startup completed。

使用的代码：

use HeadlessChromium\BrowserFactory;

$options = [
    'headless' => true,
    'noSandbox' => true,
    'keepAlive' => true,
    'disable-gpu' => true,// add this flag to show the browser window
    'closeOnExit' => false, // set this option to false to keep the browser open
    'userDataDir' => '/tmp'

];
$browserFactory = new BrowserFactory('google-chrome-stable');
$browser = $browserFactory->createBrowser();
$page = $browser->createPage();
$page->navigate('https://www.google.com')->waitForNavigation();

解决方案 #

• 确认Chrome安装与路径
  线上服务器可能未安装google-chrome-stable，或路径不正确。执行which google-chrome-stable确认可执行文件路径，若不存在可尝试安装Chrome/Chromium，或改用chromium-browser作为浏览器名称传入BrowserFactory。同时执行google-chrome-stable --version确认版本在60以上（chrome-php要求最低版本）。

• 调整启动参数

  • 将'headless' => true改为'headless' => 'new'：新版Chrome已废弃旧无头模式，使用new参数启用全新无头模式，兼容性更好。
  • 添加'disable-dev-shm-usage' => true：部分服务器的/dev/shm空间不足，该参数可强制Chrome使用临时文件而非共享内存，避免因内存不足崩溃。
  • 检查userDataDir权限：确保指定的目录（如/tmp）有Laravel运行用户（如www-data）的读写权限，或替换为Laravel存储目录下的路径，比如storage_path('app/chrome-profile')，提前创建目录并设置权限。

• 排查详细错误

  • 在代码中捕获异常并打印详细信息，定位具体问题：

    try {
        $browser = $browserFactory->createBrowser($options);
    } catch (\Exception $e) {
        // 可将日志写入文件或输出到调试工具
        file_put_contents(storage_path('logs/chrome-error.log'), $e->getMessage() . PHP_EOL . $e->getTraceAsString());
        dd($e->getMessage());
    }
    

  • 直接在服务器命令行手动执行Chrome启动命令，验证是否能正常运行：

    google-chrome-stable --headless=new --no-sandbox --disable-gpu --disable-dev-shm-usage https://www.google.com
    

    观察命令行输出的错误信息，针对性解决。

• 检查服务器环境限制

  • 部分共享主机或VPS会限制进程创建、系统调用，或内存不足。联系主机商确认是否允许运行Chrome/Chromium进程；确保服务器内存至少512MB以上，Chrome无头模式需要足够内存支撑运行。

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