无头模式下Selenium点击元素报错：element click intercepted 求助

以下是几个可行的解决方案，按优先级排序：

1. 修复Headless窗口尺寸问题 #

Headless模式下start-maximized参数经常不生效，导致默认窗口过小，元素不在可视区域内。直接显式指定窗口尺寸：

options = Options()
options.add_argument('--headless=new')  # 用Chrome新版无头模式，行为更接近正常浏览器
options.add_argument('--window-size=1920,1080')  # 强制设置窗口分辨率
options.add_argument(f'user-agent={custom_user_agent}')

2. 用显式等待替代硬等待 #

time.sleep()是不可靠的硬等待，改用Selenium的显式等待，确保元素加载完成且可点击后再操作：
首先导入等待模块：

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

然后替换原有的滚动和点击逻辑：

# 等待按钮出现
view_all_btn = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.XPATH, '//*[@id="holdings"]/div[2]/div[1]/div[1]/div[2]/div/div/div[1]/div[2]/div[3]/button'))
)

# 滚动到元素居中位置
driver.execute_script("arguments[0].scrollIntoView({behavior: 'smooth', block: 'center'});", view_all_btn)

# 等待元素可点击后再点击
WebDriverWait(driver, 5).until(
    EC.element_to_be_clickable((By.XPATH, '//*[@id="holdings"]/div[2]/div[1]/div[1]/div[2]/div/div/div[1]/div[2]/div[3]/button'))
).click()

3. 用JavaScript强制点击 #

如果元素被页面元素遮挡（比如弹窗、悬浮导航），直接用JS触发点击，绕过Selenium的可见性检查：

view_all_btn = driver.find_element(By.XPATH, '//*[@id="holdings"]/div[2]/div[1]/div[1]/div[2]/div/div/div[1]/div[2]/div[3]/button')
driver.execute_script("arguments[0].click();", view_all_btn)

完整修改后的代码 #

import time
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
from webdriver_manager.chrome import ChromeDriverManager
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

custom_user_agent = "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.111 Safari/537.36"  # noqa

options = Options()
options.add_argument('--headless=new')
options.add_argument('--window-size=1920,1080')
options.add_argument(f'user-agent={custom_user_agent}')

url = 'https://www.etf.com/SPY'

driver = webdriver.Chrome(options=options, service=Service(ChromeDriverManager().install()))  # noqa
driver.get(url)

# 等待按钮加载并滚动到可视区域
view_all_btn = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.XPATH, '//*[@id="holdings"]/div[2]/div[1]/div[1]/div[2]/div/div/div[1]/div[2]/div[3]/button'))
)
driver.execute_script("arguments[0].scrollIntoView({behavior: 'smooth', block: 'center'});", view_all_btn)

# 用JS强制点击（双重保险）
WebDriverWait(driver, 5).until(
    EC.element_to_be_clickable((By.XPATH, '//*[@id="holdings"]/div[2]/div[1]/div[1]/div[2]/div/div/div[1]/div[2]/div[3]/button'))
)
driver.execute_script("arguments[0].click();", view_all_btn)

input('wait..')
driver.quit()

关键说明 #

• 新版Headless模式--headless=new是Chrome 112+版本引入的，行为和正常浏览器几乎一致，避免旧版无头模式的兼容性问题。
• 显式等待能避免页面加载延迟导致的元素未找到问题，比硬等待更高效可靠。
• JS点击直接操作DOM元素，适用于各种元素被遮挡的场景。

内容的提问来源于stack exchange，提问作者Maurício Bertolucci