ECS任务执行报错：ChromeDriverManager().install()出现元组索引越界

核心原因分析 #

本地Docker运行正常但ECS报错，大概率是ECS环境与本地容器环境的差异导致ChromeDriverManager无法正常工作，进而触发索引越界错误。常见诱因包括：

• ECS的网络限制导致ChromeDriverManager无法下载对应版本的ChromeDriver
• 容器内Chrome浏览器未正确安装，版本检测失败
• 未显式配置无头Chrome参数，ECS无图形环境引发异常
• 容器权限不足，无法写入ChromeDriver安装目录

具体解决步骤 #

1. 预安装ChromeDriver，规避自动下载问题 #

放弃ChromeDriverManager的自动安装逻辑，在Docker镜像构建阶段就装好对应版本的Chrome浏览器和ChromeDriver，彻底避免网络和版本检测的坑：

# 直接用官方带Chrome的镜像（推荐）
FROM selenium/standalone-chrome:latest

# 如果要手动安装（Debian系示例）
# RUN apt-get update && apt-get install -y --no-install-recommends chromium chromium-driver

修改代码直接指定预安装的ChromeDriver路径：

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options

# 配置无头Chrome必需参数
chrome_options = Options()
chrome_options.add_argument("--headless=new")
chrome_options.add_argument("--no-sandbox")
chrome_options.add_argument("--disable-dev-shm-usage")

# 指向镜像内预安装的ChromeDriver路径（selenium镜像默认路径为/usr/bin/chromedriver）
driver = webdriver.Chrome(service=Service("/usr/bin/chromedriver"), options=chrome_options)

2. 强制配置无头Chrome参数 #

ECS是纯命令行环境，必须显式开启无头模式，否则Chrome启动失败会触发连锁错误，必须添加以下参数：

chrome_options.add_argument("--headless=new")  # 新版无头模式，兼容性更强
chrome_options.add_argument("--no-sandbox")    # 容器环境必需，绕过沙箱限制
chrome_options.add_argument("--disable-dev-shm-usage")  # 解决容器内存不足问题

3. 检查ECS网络权限 #

如果一定要保留ChromeDriverManager，需确保ECS任务的安全组、网络ACL允许访问ChromeDriver的下载源。可在容器内测试连通性：

curl -I https://chromedriver.storage.googleapis.com/

4. 配置容器运行权限 #

ECS任务可能以非root用户运行，需确保Chrome和ChromeDriver所在目录有可读可执行权限，可在Dockerfile中添加：

RUN chmod +x /usr/bin/chromedriver
# 若需要，可切换为root用户运行（根据实际场景调整）
USER root

验证流程 #

1. 本地Docker中添加--no-sandbox等参数模拟ECS环境测试
2. 构建新镜像推送到ECR，重新部署ECS任务验证

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