Appium 2无法获取iOS应用XCUIElementTypeStaticText文本求解决办法

iOS 15应用中有一个普通的XCUIElementTypeStaticText控件，使用WebdriverIO 8.3.2（Node.js v16.17.0）调用getText()无法获取内部文本；尝试getAttribute('value')或getAttribute('label')也无效，打印结果只显示元素的accessibilityId（reportTitleName）而非实际文本内容。当前使用Appium 2，相关代码如下：

const reportTitleName = await driver.$('~reportTitleName')
const reportName = await reportTitleName.getText() // 无效
const reportName = await reportTitleName.getAttribute('value') // 尝试value或label属性均无效

console.log('report name is: ', reportName ) // 输出reportTitleName而非实际文本

• 检查控件Accessibility属性配置
  确认iOS原生控件的accessibilityLabel和accessibilityValue是否正确设置。如果原生端错误地将accessibilityIdentifier（即reportTitleName）与文本内容绑定，会导致Appium获取到的是ID而非实际文本。需要原生开发确保控件的accessibilityLabel设置为控件显示的文本内容。

• 尝试获取其他属性
  对于XCUIElementTypeStaticText，可以尝试获取以下属性：

  // 获取label属性
  const text = await reportTitleName.getAttribute('label')
  // 获取name属性
  const text = await reportTitleName.getAttribute('name')
  // 再次尝试getText方法
  const text = await reportTitleName.getText()
  

  Appium对iOS元素属性的映射存在版本差异，name属性在多数XCUIElementTypeStaticText场景下会返回实际文本。

• 调整Appium iOS驱动配置
  在Appium的capabilities中添加或修改以下配置，确保返回完整的元素属性信息：

  {
    "appium:automationName": "XCUITest",
    "appium:shouldUseCompactResponses": false,
    "appium:useXctestrunFile": false
  }
  

  将shouldUseCompactResponses设为false可避免Appium压缩元素属性，确保能获取到完整的文本信息。

• 优化元素定位方式
  用Appium Inspector确认~reportTitleName定位到的确实是目标静态文本控件，而非父容器或其他绑定相同accessibilityId的元素。可以使用更精确的定位规则：

  const reportTitleName = await driver.$('XCUIElementTypeStaticText[accessibilityIdentifier="reportTitleName"]')
  

• 更新依赖版本
  尝试升级WebdriverIO到最新稳定版，或更新Appium XCUITest驱动（执行appium driver update xcuitest），部分版本兼容性问题可能导致文本获取失败。

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