Ubuntu 24.04下Playwright安装失败,依赖缺失问题求助
Ubuntu 24.04 配置Python版Playwright解决方案
一、干净稳定的Ubuntu 24.04原生配置方案
核心是解决虚拟环境中playwright install-deps无法执行的问题,步骤如下:
- 激活虚拟环境后,用绝对路径调用playwright执行系统依赖安装:
sudo $(which playwright) install-deps
这条命令会自动适配Ubuntu 24.04的依赖包名称,无需手动查找替换缺失的库。
2. 完成系统依赖安装后,再执行浏览器安装:
playwright install
此时依赖会被正确匹配安装,不会再出现缺失警告。
二、官方Playwright Docker镜像是否推荐?
是非常推荐的方案,尤其适合追求零配置、跨环境一致性的场景:
- 镜像已预装好所有系统依赖、浏览器和Playwright,无需手动处理版本兼容问题
- 只需挂载本地脚本目录到容器即可运行,完全隔离宿主机环境
- 适合长期维护的自动化脚本,避免系统版本更新带来的依赖断裂
示例运行命令(假设本地脚本为auto_script.py):
docker run --rm -v $(pwd):/work/ -w /work/ mcr.microsoft.com/playwright/python:v1.44.0-jammy python auto_script.py
注:请选择对应Python版本的镜像,jammy基础镜像兼容Ubuntu 24.04运行环境。
三、无需Docker的原生修复方法
如果不想使用Docker,除了上述绝对路径执行install-deps的方法外,也可以手动安装适配Ubuntu 24.04的依赖包:
- 替换原缺失包为Ubuntu 24.04对应的版本,执行以下命令:
sudo apt-get install -y libnss3 libatk-bridge2.0-0 libxss1 libasound2t64 libgbm1 libgtk-3-0 libxshmfence-dev libxrandr2 libxcomposite1 libxcursor1 libxdamage1 libxi6 libevent-2.1-7
- 安装完成后,重新激活虚拟环境并执行
playwright install即可。
补充说明
如果仅需运行简单的浏览器自动化脚本,原生配置方案足够满足需求;若需要长期稳定的跨环境运行,Docker镜像更省心。
内容的提问来源于stack exchange,提问作者Rian Santana




