You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

CloudLinux 8+cPanel+Node22环境下Puppeteer浏览器进程启动失败求助

问题:CloudLinux 8 + cPanel环境下Puppeteer无法启动浏览器进程

环境背景

  • 新服务器配置:CloudLinux 8、cPanel、Node.js 22、最新版Puppeteer
  • 旧服务器上相同代码的Puppeteer运行正常

隔离后的测试脚本

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    executablePath: '/home/my_user_folder/.cache/puppeteer/chrome-headless-shell/linux-128.0.6613.119/chrome-headless-shell-linux64',
    headless: true,
    args: [
      //'--no-sandbox',
      '--disable-dev-shm-usage',
      '--disable-setuid-sandbox',
      '--disable-gpu',
      '--disable-software-rasterizer',
      '--single-process',
      '--user-data-dir=/home/my_user_folder/tmp/puppeteer_user_data'
    ]
  });
  console.log('Browser launched!');
})();

运行错误日志

/home/my_user_folder/nodevenv/my-app/22/bin/node /home/my_user_folder/my-app/public/damnit.js
/home/my_user_folder/nodevenv/my-app/22/lib/node_modules/@puppeteer/browsers/lib/cjs/launch.js:312
                reject(new Error([
                       ^

Error: Failed to launch the browser process!


TROUBLESHOOTING: https://pptr.dev/troubleshooting

    at Interface.onClose (/home/my_user_folder/nodevenv/my-app/22/lib/node_modules/@puppeteer/browsers/lib/cjs/launch.js:312:24)
    at Interface.emit (node:events:532:35)
    at Interface.close (node:internal/readline/interface:527:10)
    at Socket.onend (node:internal/readline/interface:253:10)
    at Socket.emit (node:events:532:35)
    at endReadableNT (node:internal/streams/readable:1696:12)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)

Node.js v22.1.0

排查操作及结果

  • 依赖检查:执行ldd chrome | grep not,确认无缺失依赖
  • 手动启动浏览器:
    /home/my_user_folder/.cache/puppeteer/chrome-headless-shell/linux-128.0.6613.119/chrome-headless-shell-linux64/chrome-headless-shell --headless --no-sandbox --disable-dev-shm-usage
    
    返回结果:Trace/breakpoint trap (core dumped)
  • 内核日志:执行dmesg | grep chrome,输出如下:
    [580949.894828] traps: chrome-headless[2619634] trap int3 ip:55a569dabe26 sp:7fff5226c820 error:0 in chrome-headless-shell[55a5645a3000+884a000]
    [580977.732416] traps: chrome-headless[2619676] trap int3 ip:5569e11d1e26 sp:7ffc950fffa0 error:0 in chrome-headless-shell[5569db9c9000+884a000]
    [581190.516838] traps: chrome-headless[2620505] trap int3 ip:55779955de26 sp:7fff273bc5a0 error:0 in chrome-headless-shell[557793d55000+884a000]
    [582336.563613] traps: chrome-headless[2623748] trap int3 ip:5636a6218e26 sp:7ffcdb58fd60 error:0 in chrome-headless-shell[5636a0a10000+884a000]
    

已尝试的解决手段

  • 完整遵循官方troubleshooting文档及GitHub社区相关建议
  • 多次重装Puppeteer及配套浏览器组件(含旧版本)
  • 反复调整相关文件及目录的权限设置

恳请提供可行的解决方案。

内容的提问来源于stack exchange,提问作者user1274113

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.18 14:24:52