Android应用Appium自动化测试中OTP无法填入输入域问题咨询

问题描述 #

Android应用登录依赖OTP验证，发送OTP后需填入对应输入域完成验证，但在Appium测试过程中，调用sendKeys()无法将OTP填入目标输入框，导致测试失败。

尝试的代码实现：

Wait<WebDriver> wait = new FluentWait<WebDriver>(driver)
        .withTimeout(Duration.ofSeconds(30))
        .pollingEvery(Duration.ofSeconds(5))
        .ignoring(NoSuchElementException.class);

WebElement element = wait.until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//android.widget.EditText[@class='android.widget.EditText' and @package='in.example.com']")));
element.sendKeys(otpString);

可能的原因及解决方法 #

1. 元素定位不准确 #

当前XPath存在冗余（标签名已经是android.widget.EditText，无需重复指定class属性），可能定位到非目标输入框或多个元素，导致输入无效。

优化定位方式，优先使用唯一属性（比如resource-id），这是最可靠的定位方式：

// 用resource-id定位（推荐）
WebElement otpInput = wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("in.example.com:id/otp_edit_text")));

// 或者精简XPath，保留必要属性
WebElement otpInput = wait.until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//android.widget.EditText[@package='in.example.com' and @resource-id='otp_edit_text']")));

2. 输入框未获取焦点 #

即使元素可见，若未主动获取焦点，sendKeys()可能无法生效。

先点击输入框获取焦点，再执行输入操作：

WebElement otpInput = wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("in.example.com:id/otp_edit_text")));
otpInput.click(); // 触发焦点获取
otpInput.sendKeys(otpString);

3. Appium输入法兼容性问题 #

默认的Appium Unicode输入法可能和部分应用存在兼容性问题，导致输入失败。

在Desired Capabilities中调整输入法配置，改用系统输入法：

// 配置Desired Capabilities时添加以下参数
capabilities.setCapability("unicodeKeyboard", false);
capabilities.setCapability("resetKeyboard", false);
capabilities.setCapability("automationName", "UiAutomator2"); // 确保使用UiAutomator2驱动

4. OTP输入框为拆分式多输入框 #

很多应用的OTP输入框拆分为4-6个独立小输入框，直接定位父元素输入会无效。

逐个定位每个小输入框，分别输入OTP的每一位：

String otp = "123456"; // 示例OTP
for (int i = 0; i < otp.length(); i++) {
    WebElement singleInput = wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("in.example.com:id/otp_edit_text_" + i)));
    singleInput.sendKeys(String.valueOf(otp.charAt(i)));
}

5. 绕过Appium元素交互，用ADB直接输入 #

如果以上方法都无效，可直接通过ADB命令模拟文本输入，绕过Appium的元素交互逻辑：

// 执行ADB输入命令
Runtime.getRuntime().exec("adb shell input text " + otpString);

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