运行Puppeteer报错failed to launch the browser process，缺少libatk-1.0.so.0怎么办

• 该报错由Puppeteer内置的Chromium浏览器缺少系统层面的运行依赖导致，你当前明确缺失的是libatk-1.0.so.0对应的atk组件库，通常这类场景还会伴随其他Chromium依赖缺失，无需逐个安装，直接安装全量Chromium系统依赖即可。
• 从报错路径判断你当前运行环境为WSL下的Linux发行版，需要在Linux子系统内安装对应依赖，而非Windows系统。

1. 安装系统依赖 #

根据你使用的Linux发行版选择对应命令：

Debian/Ubuntu 系列（含WSL默认的Ubuntu） #

sudo apt update
sudo apt install -y libgtk-3-0 libgbm-dev libnss3 libxss1 libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxtst6 ca-certificates fonts-liberation libappindicator1 lsb-release xdg-utils wget

CentOS/RHEL 系列 #

sudo yum install -y alsa-lib.x86_64 atk.x86_64 cups-libs.x86_64 gtk3.x86_64 libXcomposite.x86_64 libXcursor.x86_64 libXdamage.x86_64 libXext.x86_64 libXi.x86_64 libXrandr.x86_64 libXScrnSaver.x86_64 libXtst.x86_64 pango.x86_64 xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-cyrillic xorg-x11-fonts-misc xorg-x11-fonts-Type1 xorg-x11-utils

2. 可选适配配置 #

如果安装依赖后仍启动失败，可在Puppeteer启动时添加无沙箱参数适配WSL/无图形界面环境：

const browser = await puppeteer.launch({
  args: ['--no-sandbox', '--disable-setuid-sandbox']
})

注意：--no-sandbox为非安全配置，生产环境运行请优先配置好Linux用户沙箱权限，避免使用该参数。

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