Laravel控制器中运行Puppeteer JavaScript代码失败求助

1. 统一环境变量与可执行路径 #

Laravel的Process执行环境和终端Shell的环境变量可能存在差异，需要明确指定Node的绝对路径，并确保环境变量包含必要的路径：

use Illuminate\Support\Facades\Process;

$result = Process::path(base_path('scripts'))
    ->env(['PATH' => '/usr/bin:/usr/local/bin:' . getenv('PATH')])
    ->run('/usr/bin/node your-puppeteer-script.js');

注：/usr/bin/node需替换为你服务器上Node的实际绝对路径

2. 强制启用无头模式并配置权限 #

控制器执行场景无图形界面，必须为Puppeteer配置无头模式及适配服务器环境的启动参数：

const puppeteer = require('puppeteer');

(async () => {
    const browser = await puppeteer.launch({
        headless: 'new',
        args: [
            '--no-sandbox',
            '--disable-setuid-sandbox',
            '--disable-dev-shm-usage',
            '--disable-gpu'
        ]
    });
    // 页面操作逻辑...
})();

--no-sandbox与--disable-setuid-sandbox是服务器环境下启动浏览器的必要参数，避免权限不足问题。

3. 修正文件权限与工作目录 #

• 确保Puppeteer脚本文件、项目的node_modules目录，以及Puppeteer缓存目录（默认~/.cache/puppeteer）拥有Laravel进程用户（通常为www-data或nginx）的读写权限。
• 在Process中指定脚本所在的工作目录，避免路径解析错误：

$result = Process::path(base_path('scripts'))->run('node your-script.js');

4. 捕获执行日志定位问题 #

不要忽略Process的输出信息，通过打印标准输出和错误输出排查具体故障：

$result = Process::run('node your-puppeteer-script.js');

// 输出执行日志
echo $result->output();
echo $result->errorOutput();

常见报错包括：Node模块缺失、浏览器启动权限不足、路径错误等。

5. 确保依赖安装完整 #

终端运行时使用的Puppeteer可能是全局安装，但Laravel进程用户可能无法访问。建议在Laravel项目目录下本地安装依赖：

cd your-laravel-project
npm install puppeteer

6. 调整进程超时时间 #

Puppeteer启动浏览器及页面操作耗时较长，可延长Process的超时限制：

$result = Process::timeout(300)->run('node your-puppeteer-script.js');

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