Robot Framework+Selenium中Click Element关键字失效问题排查求助

问题背景 #

页面分页控件结构如下：

<div class="grid-nav-controls">
  <span class="grid-nav-link" page-index="1">1</span>
  <span class="grid-nav-separator">| 
  </span><span class="grid-nav-link" page-index="2">2</span>
  <span class="grid-nav-separator">|</span>
  <div class="grid-nav-current-page">3</div>
  <span class="grid-nav-separator">|</span>
  <span class="grid-nav-link" page-index="4">4</span>
</div>

需定位page-index='4'或文本为4的span按钮，已确认元素存在、可见、启用且已滚动到视图内，但以下操作均未触发分页跳转（日志显示所有关键字执行成功无报错）：

• Wait Until Keyword Succeeds ${interval} ${timeout} Click Element ${locator}
• Click Element ${locator}
• Click Element ${locator} action_chain=True
• Click Element at Coordinates ${locator} 0 0
• 自定义ActionChains关键字：

@keyword("Perform Click Element")
def perform_click_element(self, element):
    self.driver = self.get_webdriver_instance()
    action = ActionChains(self.driver)
    try:
        action.move_to_element(element).click().perform()
    except Exception as e:
        logger.error(e)

使用过的定位器：

${locator}  //span[text()='4']
${locator}  //span[@page-index='4']

排查方向 #

• 检查元素是否被遮挡：即使元素可见，可能存在透明层、固定导航栏等上层元素覆盖目标区域。可通过浏览器开发者工具验证：
  1. 在Elements面板右键目标元素选择Inspect，查看z-index属性判断层级；
  2. 在Console执行document.elementFromPoint(x,y)（x,y为元素的绝对坐标），确认返回的是否为目标span元素。
• 验证点击事件绑定逻辑：部分页面的点击事件通过事件委托绑定在父元素而非目标span本身。可通过以下方式确认：
  1. 在Elements面板的Event Listeners标签，查看目标元素及其父元素的click事件；
  2. 在Console手动执行document.querySelector("span[page-index='4']").click()，若能触发分页跳转，说明是Selenium模拟点击的上下文问题，而非页面事件逻辑问题。
• 尝试JavaScript触发点击：绕过Selenium的模拟交互，直接用JS触发元素点击：

  Execute JavaScript  document.querySelector("span[page-index='4']").click();
  

  若此方法有效，说明是浏览器对Selenium模拟点击的限制，或元素存在隐性交互要求（如需要真实鼠标移动轨迹）。
• 确认页面加载状态：元素可见不代表页面异步资源加载完成，可能导致点击时机过早。可添加等待逻辑，比如等待加载指示器消失，或使用Wait Until Page Contains Element确保页面状态稳定后再执行点击。
• 检查浏览器驱动兼容性：ChromeDriver/GeckoDriver版本与浏览器版本不匹配可能导致交互异常。尝试更新驱动至对应浏览器的最新兼容版本。
• 排查元素可点击区域：部分元素的CSS属性（如padding、margin、pointer-events）可能导致视觉区域与实际可交互区域不一致。在Elements面板的Computed标签查看pointer-events是否为none，或检查元素的实际尺寸和位置。

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