解决 Ubuntu 22.04 上 Playwright 缺少依赖库的问题

在 Ubuntu 22.04 上运行 Playwright 时,可能会遇到以下错误:

error while loading shared libraries: libatk-1.0.so.0: cannot open shared object file: No such file or directory

这个错误表明系统缺少运行 Playwright 所需的基础依赖库。

解决方案

运行以下命令来安装所需的依赖:

sudo apt-get update

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

依赖库说明

以上安装的依赖库主要包括:

• libatk1.0-0: ATK 辅助功能工具包
• libatk-bridge2.0-0: ATK 桥接库
• libcups2: 通用 UNIX 打印系统库
• libdrm2: 直接渲染管理库
• libxkbcommon0: X 键盘通用库
• libxcomposite1: X11 Composite 扩展库
• libxdamage1: X11 损坏扩展库
• libxfixes3: X11 修复扩展库
• libxrandr2: X11 RandR 扩展库
• libgbm1: Mesa GBM 库
• libpango-1.0-0: Pango 布局和渲染库
• libcairo2: Cairo 2D 图形库
• libasound2: ALSA 声音库
• libatspi2.0-0: 辅助技术服务提供接口

Docker 环境

如果你在 Docker 环境中使用 Playwright,可以参考官方的 Dockerfile:

FROM mcr.microsoft.com/playwright:v1.40.0-jammy

更多详情可以参考 Playwright Docker 文档。

注意事项

1. 如果安装完依赖后仍然出现类似错误,请检查错误信息中提示的具体缺失库文件,并相应安装。

2. 建议在安装依赖后重新启动应用程序。

3. 如果使用的是非 root 用户,记得在命令前加上 sudo。

参考资料

• Playwright 官方文档
• Ubuntu 包管理文档