使用Selenium无法定位老虎机游戏图标该如何解决？

定位失败常见原因及解决方案 #

• 等待时机问题
  页面DOM渲染、游戏列表异步加载晚于脚本执行时间，是这类问题的最高发原因。不要使用绝对路径的XPath（/html开头的定位方式容错率极低，页面结构稍有变动就会失效），改用显式等待匹配元素：

  from selenium.webdriver.common.by import By
  from selenium.webdriver.support.ui import WebDriverWait
  from selenium.webdriver.support import expected_conditions as EC
  
  # 最多等待10秒，直到元素可点击再执行点击
  wait = WebDriverWait(self.driver, 10)
  game_icon = wait.until(EC.element_to_be_clickable((By.ID, "jackpot_01001")))
  game_icon.click()
  

• iframe嵌套问题
  游戏类页面通常会把游戏列表模块放在独立的iframe中，未切换到对应iframe时无法定位到内部元素，处理方式如下：

  # 先定位到游戏列表所在的iframe，替换为实际的iframe定位规则
  iframe = self.driver.find_element(By.CSS_SELECTOR, "iframe[src*=game_list]")
  self.driver.switch_to.frame(iframe)
  # 切换完成后再定位元素
  self.driver.find_element(By.ID, "jackpot_01001").click()
  # 操作完成后如果要操作外层页面，需要切回主文档
  # self.driver.switch_to.default_content()
  

• 动态属性问题
  如果元素ID是页面加载时动态生成的，固定ID匹配会失效，可以改用部分属性匹配的相对XPath：

  # 匹配ID包含jackpot_前缀的元素
  self.driver.find_element(By.XPATH, '//*[starts-with(@id,"jackpot_")]').click()
  # 也可以结合游戏名称文本定位，替换为实际的老虎机游戏名称
  self.driver.find_element(By.XPATH, '//*[contains(text(),"老虎机游戏名称")]').click()
  

• Shadow DOM问题
  如果页面用了Web Components封装组件，元素位于Shadow DOM中，常规定位规则无法命中，需要先获取Shadow Root再查找元素：

  # 先定位Shadow DOM的宿主元素
  host = self.driver.find_element(By.CSS_SELECTOR, "shadow-host-selector")
  shadow_root = self.driver.execute_script("return arguments[0].shadowRoot", host)
  # 从Shadow Root中查找目标元素
  shadow_root.find_element(By.ID, "jackpot_01001").click()
  

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