Puppeteer在Linux部署服务器上PDF生成失败求助

问题原因 #

错误提示libatk-1.0.so.0: cannot open shared object file: No such file or directory说明Puppeteer下载的无头Chrome浏览器缺少必要的系统依赖库。本地Linux环境（通常为桌面版）默认预装了这些桌面相关依赖，但Ubuntu服务器版多为最小化安装，缺失这类库。

解决方案 #

针对Ubuntu/Debian服务器，执行以下命令安装所有必需的依赖：

1. 更新系统包列表

sudo apt update

2. 安装Chrome核心依赖库

sudo apt install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2

如果上述命令仍有遗漏，可以使用更完整的依赖安装集合：

sudo apt-get install -y gconf-service 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 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget

代码配置验证 #

你的代码中已经添加了--no-sandbox和--disable-setuid-sandbox参数，这在服务器环境是必要的（服务器通常不支持Chrome的沙箱机制），这部分配置无需修改。

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