通过类名定位元素返回空列表的问题排查

可能的原因及对应解决方案 #

• 元素未完成加载就执行查找
  点击展开箭头后，表格内容需要异步渲染，直接调用find_elements会因为元素还未加载完成返回空列表。解决方法是使用显式等待，等待目标元素出现：

  from selenium.webdriver.support.ui import WebDriverWait
  from selenium.webdriver.support import expected_conditions as EC
  
  # 最长等待10秒，直到目标元素加载完成
  all_vessels = WebDriverWait(self.driver, 10).until(
      EC.presence_of_all_elements_located((By.CLASS_NAME, "anchorage-by-terminal"))
  )
  print(all_vessels)
  

• 定位的class属性不正确
  先确认anchorage-by-terminal是否是船舶列表元素的正确class：

  1. 打开浏览器开发者工具（F12）
  2. 点击展开箭头后，在Elements面板中手动定位船舶列表元素，核对其class属性。
     如果该class仅对应容器而非单个船舶项，需调整定位逻辑，比如先找容器再取内部子元素：

  # 先定位容器，再查找内部的船舶条目（示例假设船舶项是tr标签）
  container = self.driver.find_element(By.CLASS_NAME, "anchorage-by-terminal")
  all_vessels = container.find_elements(By.TAG_NAME, "tr")
  

• 元素嵌套在iframe内
  若表格内容被嵌套在iframe中，需先切换到对应iframe才能定位元素：

  # 定位并切换到目标iframe（需替换为实际iframe的定位方式，比如ID、class）
  iframe = self.driver.find_element(By.ID, "target-iframe-id")
  self.driver.switch_to.frame(iframe)
  
  # 执行元素查找
  all_vessels = self.driver.find_elements(By.CLASS_NAME, "anchorage-by-terminal")
  
  # 操作完成后切回主文档
  self.driver.switch_to.default_content()
  

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