无法安装Puppeteer求助：重复报错已尝试多种排查方案

问题背景 #

已安装 Chromium 与 puppeteer-core，Node.js 版本 18.16.0、npm 版本 9.7.1，删除 node_modules 及 package-lock.json 后重新执行 sudo npm install 仍报错，报错日志如下：

andres@andres-VirtualBox:~/Documents/theceshop/plat-web-components$ sudo npm install
[sudo] password for andres:
npm ERR! code 1
npm ERR! path /home/andres/.local/share/Trash/files/plat-web-components/node_modules/puppeteer
npm ERR! command failed
npm ERR! command sh -c node install.js

npm ERR! A complete log of this run can be found in: /root/.npm/_logs/2023-06-21T20_50_37_257Z-debug-0.log

解决步骤 #

1. 修复权限并避免 sudo 执行 npm #

sudo 会打乱项目文件权限，先重置权限：

sudo chown -R $USER:$USER /home/andres/.local/share/Trash/files/plat-web-components
sudo chown -R $USER:$USER /root/.npm

之后用普通用户权限执行安装：

npm install

2. 跳过 Chromium 自动下载 #

既然已手动安装 Chromium，让 Puppeteer 跳过浏览器下载：

• 临时生效方式：

PUPPETEER_SKIP_DOWNLOAD=true npm install

• 项目永久配置：在根目录 .npmrc 文件中添加：

puppeteer_skip_download=true

再执行 npm install

3. 查看完整日志定位具体错误 #

仅当前日志无法确定 install.js 失败原因，查看完整日志：

cat /root/.npm/_logs/2023-06-21T20_50_37_257Z-debug-0.log

如果是系统依赖缺失，Ubuntu/Debian 可安装所需依赖：

sudo apt-get install -y libnss3 libatk-bridge2.0-0 libdrm-dev libxkbcommon-dev libgbm-dev libasound-dev libatspi2.0-0 libxshmfence-dev

4. 直接使用 puppeteer-core #

已安装 puppeteer-core，可直接在代码中指定本地 Chromium 路径使用，无需安装 Puppeteer：

const puppeteer = require('puppeteer-core');

(async () => {
  const browser = await puppeteer.launch({
    executablePath: '/usr/bin/chromium-browser', // 替换为你的 Chromium 实际路径
    headless: true
  });
  // 后续业务代码
})();

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