AWS EC2 Linux运行chromedriver报错无法打开libxcb.so.1共享对象文件
报错原因确认
你的判断准确,该报错确实是实例缺少libxcb共享库导致。libxcb是X Window系统的底层通信库,Chrome、Chromedriver运行依赖X11图形协议栈的相关组件,AWS EC2默认提供的Linux最小化镜像不会预装这类图形相关依赖,运行时就会触发共享对象文件找不到的错误。
修复步骤
- 先确认实例的Linux发行版,执行命令查看系统信息:
cat /etc/os-release
根据返回的系统类型选择对应依赖安装命令,一次性装齐Chrome/Chromedriver运行所需的全部依赖,避免后续反复出现其他共享库缺失报错:
- 若为Amazon Linux 2/CentOS/RHEL系列:
sudo yum install -y libxcb libX11 libXcomposite libXcursor libXdamage libXext libXi libXtst libXrandr libXrender alsa-lib atk cups-libs gtk3 pango
- 若为Ubuntu/Debian系列:
sudo apt update && sudo apt install -y libxcb1 libx11-6 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxi6 libxtst6 libxrandr2 libxrender1 libasound2 libatk1.0-0 libcups2 libgtk-3-0 libpango-1.0-0
- 给已移动到
/usr/bin下的chromedriver添加可执行权限(解压后默认可能无执行权限):sudo chmod +x /usr/bin/chromedriver - 修正你之前输错的校验命令(
version参数前是两个连续短横,中间无空格),重新执行校验:chromedriver --version
正常执行会返回对应102.0.5005.61的版本信息,不再报共享库缺失错误。
后续搭建Selenium环境的注意事项
- 你目前仅安装了Chromedriver,尚未安装对应102大版本的Chrome浏览器本体,Selenium无法单独调用Chromedriver完成启动,需要补装同版本Chrome。
- EC2实例无图形桌面环境,初始化Selenium的ChromeOptions时必须添加以下启动参数,否则会启动失败:
--headless=new(启用新版无头模式)--no-sandbox(关闭沙箱,适配root权限运行场景)--disable-dev-shm-usage(规避EC2默认/dev/shm分区过小导致的崩溃问题)
- 如果后续仍出现共享库缺失报错,可执行
ldd /usr/bin/chromedriver查看所有未找到的依赖项,对应安装所属系统包即可。
内容的提问来源于stack exchange,提问作者plimpa
相关产品推荐
相关产品推荐

