Appium-Python滚动选国家后字段未填充，报StaleElementReferenceException

问题场景 #

我是Appium新手，用真实安卓设备自学Telegram自动化测试，执行以下流程时遇到问题：

• 在手机号输入页点击国家字段，进入国家列表页；
• 滚动找到目标国家（如🇧🇪 Belgium）；
• 点击国家后返回手机号输入页；
• 国家字段未填充，Appium返回StaleElementReferenceException错误；
• 已尝试在等待方法中忽略该异常、增加超时时间（10→20秒）、更换UiAutomator/XPath定位器，均无效。

选择无需滚动的阿尔巴尼亚时字段可正常填充，推测滚动操作影响流程，但不知原因及解决方法。期望滚动选择后字段能正确填充并完成断言。

测试代码 #

def test_select_country(self):
    # 导航到手机号输入页面
    startMessenging_btn = wait_for_element(self.driver, AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().text("Start Messaging")')
    assert startMessenging_btn is not None
    startMessenging_btn.click()
    
    # 点击进入国家选择页面
    phone_num_screen_country_element = wait_for_element(self.driver, AppiumBy.ACCESSIBILITY_ID, 'Country')
    assert phone_num_screen_country_element is not None
    phone_num_screen_country_element.click()

    # 滚动到目标国家
    scroll_to_country = self.driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 
                    'new UiScrollable(new UiSelector().scrollable(true).instance(0)).scrollIntoView(new UiSelector().text("🇧🇪 Belgium").instance(0))'
                    )
    assert scroll_to_country.is_displayed()
    
    # 奇怪的是，不用滚动的国家能正常选中，滚动后点击操作在设备上可见，但返回页面后字段不更新
    select_country = self.driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR,'new UiSelector().text("🇧🇪 Belgium")') 
    assert select_country.text == "🇧🇪 Belgium"
    select_country.click()

# 这里抛出StaleElementReferenceException，Appium返回手机号输入页时是否会重绘页面？
    phone_num_screen_country_populated = wait_for_element(self.driver, AppiumBy.XPATH, '//android.widget.TextView[@text="🇧🇪 Belgium"]')
    assert phone_num_screen_country_populated.text == "🇧🇪 Belgium"

等待方法代码 #

def wait_for_element(driver: 'WebDriver', locator: str, value: str, timeout_sec: float = 10) -> 'WebElement':
"""等待元素定位完成

参数:
    driver: WebDriver实例
    locator: 定位器类型，如AppiumBy.ACCESSIBILITY_ID
    value: 定位查询值
    timeout_sec: 最大等待时间，超时则抛出TimeoutException

异常:
    selenium.common.exceptions.TimeoutException

返回:
    找到的WebElement
"""
ignored_exceptions=(NoSuchElementException,StaleElementReferenceException,)
return WebDriverWait(driver, timeout_sec, ignored_exceptions=ignored_exceptions).\
until(EC.presence_of_element_located((locator, value)))

问题分析与解决建议 #

原因推测 #

1. 页面重绘导致元素失效：返回手机号输入页时，页面可能进行了重渲染，之前缓存的元素引用失效，触发StaleElementReferenceException。
2. 滚动后元素状态异常：UiScrollable操作可能导致目标国家元素的DOM状态变化，点击后页面未正确触发更新逻辑。
3. 断言时机过早：使用presence_of_element_located仅判断元素存在，未等待元素可见或可交互，导致断言时元素尚未完成更新。

解决方法 #

1. 优化等待条件：将等待条件从presence_of_element_located改为visibility_of_element_located或element_to_be_clickable，确保元素完全加载并可交互：

   # 修改等待方法中的until条件
   return WebDriverWait(driver, timeout_sec, ignored_exceptions=ignored_exceptions).\
       until(EC.visibility_of_element_located((locator, value)))
   

2. 重新定位返回后的元素：回到手机号输入页后，不要依赖旧元素引用，重新通过稳定的定位器（如ACCESSIBILITY_ID）获取国家字段元素，再验证文本：

   # 回到手机号输入页后重新定位国家字段
   phone_num_screen_country_element = wait_for_element(self.driver, AppiumBy.ACCESSIBILITY_ID, 'Country')
   assert phone_num_screen_country_element.text == "🇧🇪 Belgium"
   

3. 优化滚动后的点击逻辑：滚动到目标国家后，直接使用滚动操作返回的元素进行点击，避免重复查找元素：

   # 滚动后直接点击返回的元素
   scroll_to_country.click()
   

4. 添加页面切换等待：从国家列表页返回手机号输入页时，添加显式等待确认页面切换完成（如等待手机号输入框出现）。

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