使用Selenium添加商品至购物车时触发TimeoutException问题排查

问题描述 #

我尝试用以下Selenium代码将商品添加到购物车：

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

if __name__ == '__main__': 
  os.environ['WDM_LOG'] = '0' 
  options = Options()
  options.add_argument("start-maximized")
  options.add_experimental_option("prefs", {"profile.default_content_setting_values.notifications": 1})    
  options.add_experimental_option("excludeSwitches", ["enable-automation"])
  options.add_experimental_option('excludeSwitches', ['enable-logging'])
  options.add_experimental_option('useAutomationExtension', False)
  options.add_argument('--disable-blink-features=AutomationControlled') 
  srv=Service()     
  driver = webdriver.Chrome (service=srv, options=options)    
  waitWD = WebDriverWait (driver, 10)         

  link = "https://www.farmaline.be/pharmacie/commander/davitamon-more-energy-3-in-1-11-gratuit/" 
  driver.get (link)     
  waitWD.until(EC.presence_of_element_located((By.XPATH,'(//input[@x-model="quantity"])[3]'))).clear()
  time.sleep(1)
  waitWD.until(EC.presence_of_element_located((By.XPATH,'(//input[@x-model="quantity"])[3]'))).send_keys("50")     
  time.sleep(1)    
  waitWD.until(EC.element_to_be_clickable((By.XPATH, '//button[@title="Ajouter au panier"]'))).click()    
  driver.quit()

运行后触发TimeoutException：

$ python temp1.py
Traceback (most recent call last):
  File "G:\DEV\Fiverr\ORDER\tijsengel\temp1.py", line 30, in <module>
    waitWD.until(EC.element_to_be_clickable((By.XPATH, '//button[@title="Ajouter au panier"]'))).click()
  File "G:\DEV\.venv\selenium\lib\site-packages\selenium\webdriver\support\wait.py", line 95, in until
    raise TimeoutException(message, screen, stacktrace)
selenium.common.exceptions.TimeoutException: Message:

我用XPath //button[@title="Ajouter au panier"] 在开发者工具里能找到元素，但代码就是运行失败，请问原因是什么？

可能的原因及解决方案 #

1. 元素处于iframe中 #

部分电商网站会把购物车相关元素放在iframe内，开发者工具会自动切换到对应iframe上下文，但Selenium默认在主文档中，无法直接定位iframe内的元素。

• 解决方法：先切换到目标iframe，再定位按钮：

  # 在点击按钮前添加以下代码（需根据实际iframe的定位调整XPath）
  iframe = waitWD.until(EC.presence_of_element_located((By.XPATH, '//iframe[contains(@src, "cart")]')))
  driver.switch_to.frame(iframe)
  # 执行点击操作
  waitWD.until(EC.element_to_be_clickable((By.XPATH, '//button[@title="Ajouter au panier"]'))).click()
  # 操作完成后切回主文档（若后续有其他操作）
  driver.switch_to.default_content()
  

2. XPath定位不够精准 #

页面可能存在多个匹配该XPath的元素，其中只有部分是可交互状态；或者元素的父容器结构在运行时发生变化，导致定位失效。

• 解决方法：优化XPath，结合父元素或其他属性缩小范围：

  # 示例：结合商品容器的class定位，确保唯一匹配
  waitWD.until(EC.element_to_be_clickable((By.XPATH, '//div[contains(@class, "product-main")]//button[@title="Ajouter au panier"]'))).click()
  

3. 元素被遮挡或页面未完全加载 #

固定的time.sleep(1)可能不足以让页面加载完成，按钮可能被加载遮罩、cookie弹窗等元素遮挡，导致element_to_be_clickable条件不满足。

• 解决方法：
  • 等待加载遮罩消失后再操作：

    waitWD.until(EC.invisibility_of_element_located((By.XPATH, '//div[contains(@class, "loading-overlay")]')))
    

  • 提前处理cookie弹窗：

    try:
        waitWD.until(EC.element_to_be_clickable((By.XPATH, '//button[contains(text(), "Accepter")]'))).click()
    except:
        pass
    

4. 网站反爬机制限制 #

即使禁用了自动化标识，网站仍可能通过鼠标轨迹、请求频率等检测到Selenium，限制元素交互。

• 解决方法：
  • 模拟真实用户的鼠标移动后再点击：

    from selenium.webdriver.common.action_chains import ActionChains
    
    button = waitWD.until(EC.element_to_be_clickable((By.XPATH, '//button[@title="Ajouter au panier"]')))
    ActionChains(driver).move_to_element(button).click().perform()
    

  • 延长操作间隔，模拟真实用户行为，比如将time.sleep(1)调整为time.sleep(2)。

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