Recaptcha音频验证按钮定位失败问题排查求助

问题概况 #

之前正常运行的验证码脚本，最近卡在定位recaptcha-audio-button这一步，错误出在：

WebDriverWait(driver, 5).until(EC.element_to_be_clickable((By.ID, "recaptcha-audio-button")))

仅能拿到无具体错误类型的调用栈（见下方），换用类名查找也没用。

完整脚本代码 #

def solve_captcha(driver):
  WebDriverWait(driver, 10).until(EC.presence_of_element_located((By.TAG_NAME, "iframe")))
  frames = driver.find_elements(By.TAG_NAME, "iframe")

  recaptcha_control_frame = None
  recaptcha_challenge_frame = None
  for index, frame in enumerate(frames):
      if re.search('reCAPTCHA', frame.get_attribute("title")):
          recaptcha_control_frame = frame

      if re.search('recaptcha challenge', frame.get_attribute("title")):
          recaptcha_challenge_frame = frame

  #click recaptcha
  driver.switch_to.frame(recaptcha_control_frame)
  WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.CLASS_NAME, "recaptcha-checkbox-border")))
  driver.find_element(By.CLASS_NAME, "recaptcha-checkbox-border").click()
  driver.switch_to.default_content()

  #click on audio challenge
  driver.switch_to.frame(recaptcha_challenge_frame)
  WebDriverWait(driver, 5).until(EC.element_to_be_clickable((By.ID, "recaptcha-audio-button")))
  driver.find_element(By.ID, "recaptcha-audio-button").click()
  driver.switch_to.default_content()

  #switch to recaptcha audio challenge frame
  driver.switch_to.frame(recaptcha_challenge_frame)

  path_to_wav = find_and_export_wav()
  solution = solve(path_to_wav)
  result = submit_and_check(solution, recaptcha_control_frame)
  return result

错误堆栈 #

Stacktrace:
#0 0x55cdd7ef77f9 <unknown>
#1 0x55cdd7e973b3 <unknown>
#2 0x55cdd7bdf016 <unknown>
#3 0x55cdd7c1381e <unknown>
#4 0x55cdd7c498fb <unknown>
#5 0x55cdd7c36ded <unknown>
#6 0x55cdd7c479e1 <unknown>
#7 0x55cdd7c36c93 <unknown>
#8 0x55cdd7c08ce4 <unknown>
#9 0x55cdd7c0a4d2 <unknown>
#10 0x55cdd7ec3542 <unknown>
#11 0x55cdd7ed2ce7 <unknown>
#12 0x55cdd7ed29e4 <unknown>
#13 0x55cdd7ed713a <unknown>
#14 0x55cdd7ed35b9 <unknown>
#15 0x55cdd7eb8e00 <unknown>
#16 0x55cdd7eea5d2 <unknown>
#17 0x55cdd7eea778 <unknown>
#18 0x55cdd7f02a1f <unknown>
#19 0x7f93e9c40b43 <unknown>
#20 0x7f93e9cd2a00 <unknown>

可能的原因及排查建议 #

• reCAPTCHA DOM结构更新：Google经常悄悄修改reCAPTCHA的元素属性，比如iframe的title、音频按钮的ID/类名。你之前靠title匹配iframe，要是title文本变了，recaptcha_challenge_frame就会定位错误，后续切到错误的frame自然找不到按钮。
  排查：手动打开页面，用开发者工具查看当前iframe的title、音频按钮的属性有没有变化；可以改用src属性匹配iframe（比如包含recaptcha/api2/bframe的一般是挑战frame）。

• iframe切换时机不对：点击复选框后，reCAPTCHA需要加载挑战界面，你可能在内容还没渲染完就切换了frame，或者当前匹配的recaptcha_challenge_frame不是最新的挑战frame（有些场景下会新增iframe）。
  排查：点击复选框后添加等待逻辑，确保挑战界面加载完成；或者在切换frame前重新遍历一次iframe，确认目标frame里确实存在音频按钮元素。

• 等待时间不足：当前仅设置5秒等待时间，要是网络较慢或者reCAPTCHA加载延迟，元素还没变成可点击状态就触发了超时。
  排查：把等待时间改成10秒试试；如果元素存在但被遮挡，可先用EC.visibility_of_element_located确认元素可见，再判断是否可点击。

• 触发反爬机制：reCAPTCHA会检测自动化行为，要是你的脚本被识别成爬虫，可能会隐藏音频按钮、阻止交互，甚至返回异常DOM结构。常见触发点：使用无头浏览器未配置指纹、请求频率过高、未模拟真实用户操作（比如鼠标移动、页面滚动）。
  排查：检查浏览器配置，添加指纹模拟；降低请求频率，加入随机延迟；在脚本里增加一些用户行为模拟步骤。

• iframe匹配逻辑有漏洞：你用re.search匹配title，但如果页面有多个title含recaptcha challenge的iframe，可能会匹配到错误的目标；另外get_attribute("title")可能返回None，导致匹配失败，最终recaptcha_challenge_frame为None，切换frame时直接报错。
  排查：添加判断逻辑，确保recaptcha_challenge_frame不为None再执行后续操作；优化匹配逻辑，比如结合src和title双重验证。

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