Python Selenium使用Chrome无头模式时遭遇TimeoutException问题求助

问题背景 #

在Python Selenium项目中启用Chrome无头模式后，执行以下代码时触发TimeoutException：

WebDriverWait(driver, 20).until(EC.element_to_be_clickable((By.XPATH, "//button[@class=' css-1hy2vtq']"))).click()

但直接使用find_element()可以正常定位到目标元素。

可能原因及解决方法 #

1. 无头模式默认窗口尺寸过小，元素不在可视区域 #

Chrome无头模式默认窗口尺寸远小于正常浏览器，目标元素可能因不在可视范围内被判定为不可点击。解决方法是显式设置窗口大小：

from selenium import webdriver

options = webdriver.ChromeOptions()
options.add_argument("--headless=new")  # 推荐使用新版无头模式
options.add_argument("--window-size=1920,1080")  # 设置为常规桌面窗口尺寸
driver = webdriver.Chrome(options=options)

2. 元素存在但未滚动到可视区域 #

即使元素已加载完成，若不在当前视窗内，element_to_be_clickable会判定为不可点击。可以先将元素滚动到可视区域，再等待点击：

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By

# 先等待元素存在
element = WebDriverWait(driver, 20).until(
    EC.presence_of_element_located((By.XPATH, "//button[@class=' css-1hy2vtq']"))
)
# 滚动到元素位置
driver.execute_script("arguments[0].scrollIntoView({block: 'center', behavior: 'smooth'});", element)
# 再等待元素可点击并点击
WebDriverWait(driver, 10).until(
    EC.element_to_be_clickable((By.XPATH, "//button[@class=' css-1hy2vtq']"))
).click()

3. 元素被遮挡（如弹窗、遮罩层） #

无头模式下页面渲染或元素加载时机可能与正常模式不同，目标元素可能被临时弹窗、遮罩层遮挡。需先处理遮挡元素，例如关闭弹窗后再操作目标按钮。

4. 改用JS点击兜底 #

若以上方法无效，可跳过element_to_be_clickable的等待，直接使用JavaScript执行点击操作（适用于元素存在但因样式/布局问题无法被Selenium模拟点击的场景）：

element = WebDriverWait(driver, 20).until(
    EC.presence_of_element_located((By.XPATH, "//button[@class=' css-1hy2vtq']"))
)
driver.execute_script("arguments[0].click();", element)

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