如何用Python Selenium点击Hcaptcha复选框并解决元素不可交互问题

Hcaptcha组件的复选框默认嵌套在独立的iframe中，你直接在主页面DOM中查找#checkbox元素，要么定位到的是不可交互的占位隐藏元素，要么元素处于未激活的iframe上下文内，所以触发ElementNotInteractableException报错；同时普通的点击方式容易被Hcaptcha的反爬机制识别到自动化特征，直接拦截操作。

1. 先添加Selenium反检测配置 #

启动浏览器时添加以下配置，隐藏自动化特征，避免被Hcaptcha直接拦截：

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

options = webdriver.ChromeOptions()
# 移除自动化标记
options.add_experimental_option("excludeSwitches", ["enable-automation"])
options.add_experimental_option('useAutomationExtension', False)
options.add_argument("--disable-blink-features=AutomationControlled")
# 解决兼容问题
options.add_argument('--no-sandbox')
options.add_argument('--disable-gpu')

driver = webdriver.Chrome(options=options)
# 修改webdriver特征值
driver.execute_cdp_cmd("Page.addScriptToEvaluateOnNewDocument", {
  "source": """
    Object.defineProperty(navigator, 'webdriver', {
      get: () => undefined
    })
  """
})

2. 切换到Hcaptcha对应iframe #

打开目标页面后，先等待Hcaptcha的iframe加载完成，再切换到该iframe上下文：

driver.get("https://gleam.io/gIxR1/cyball-x-ancient8-20-common-packs-cyblocs-1000-usdt-social-giveaways")
# 等待iframe加载并切换
hcaptcha_iframe = WebDriverWait(driver, 20).until(
    EC.presence_of_element_located((By.XPATH, '//iframe[contains(@src,"hcaptcha.com") and @title="hCaptcha 复选框"]'))
)
driver.switch_to.frame(hcaptcha_iframe)

3. 模拟人工点击复选框 #

使用动作链模拟真实用户的点击行为，避免直接调用click或者js点击触发反爬：

# 等待复选框可交互
check_box = WebDriverWait(driver, 10).until(
    EC.element_to_be_clickable((By.ID, 'checkbox'))
)
# 滚动到元素可见位置
driver.execute_script("arguments[0].scrollIntoView({block: 'center'});", check_box)
time.sleep(0.5)
# 动作链模拟点击
ActionChains(driver).move_to_element(check_box).pause(0.2).click().perform()

# 操作完成后切回主页面DOM，进行后续操作
driver.switch_to.default_content()

• 不要启用无头模式，Hcaptcha对无头浏览器的拦截概率极高，必须使用可视化界面运行。
• 如果还是点击无响应，可检查iframe的定位是否准确，Hcaptcha存在多个嵌套iframe，需选择嵌套复选框的对应iframe，不要选错后续图片验证的iframe。
• 可适当调整延迟时间，模拟真实用户的操作节奏，避免操作过快被拦截。

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