You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

AWS EC2 Linux运行chromedriver报错无法打开libxcb.so.1共享对象文件

报错原因确认

你的判断准确,该报错确实是实例缺少libxcb共享库导致。
libxcb是X Window系统的底层通信库,Chrome、Chromedriver运行依赖X11图形协议栈的相关组件,AWS EC2默认提供的Linux最小化镜像不会预装这类图形相关依赖,运行时就会触发共享对象文件找不到的错误。

修复步骤
  1. 先确认实例的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
  1. 给已移动到/usr/bin下的chromedriver添加可执行权限(解压后默认可能无执行权限):
    sudo chmod +x /usr/bin/chromedriver
  2. 修正你之前输错的校验命令(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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.02 08:51:28