WebDriverIO混合应用自动化：Android13/15 WebView切换失败问题

核心原因分析 #

Android不同版本对WebView的调试权限、进程隔离逻辑存在差异：

• Android14默认开放了WebView调试的进程权限，而13/15版本需要额外配置或适配进程识别规则
• 自定义switchToContext方法未兼容新版本的WebView进程命名逻辑，导致请求中止

分步解决方案 #

1. 确保WebView调试模式完全开启 #

在React Native的WebView组件中强制开启调试：

<WebView
  javaScriptEnabled={true}
  domStorageEnabled={true}
  setWebContentsDebuggingEnabled={true} // 关键配置
  // 其他业务属性
/>

同时在设备开发者选项中手动开启「WebView调试」开关（部分13/15设备需单独启用）。

2. 修正上下文匹配逻辑 #

Android13+的WebView可能存在独立渲染进程，默认的WEBVIEW_${packageName}格式无法精准匹配，改为动态筛选上下文：

async function switchToWebView(packageName) {
  const contexts = await driver.getContexts();
  // 匹配包含包名的所有WebView上下文（兼容带进程ID后缀的情况）
  const targetContext = contexts.find(ctx => ctx.includes(`WEBVIEW_${packageName}`));
  if (!targetContext) {
    throw new Error(`未找到目标WebView上下文，当前可用列表：${contexts.join(', ')}`);
  }
  await driver.switchContext(targetContext);
}

3. 调整WebDriverIO/Appium配置 #

在wdio.conf.js中添加Android专属配置，适配Chromedriver与WebView版本：

capabilities: [{
  // 基础配置
  'appium:deviceName': 'Android Device',
  'appium:platformVersion': '13',
  // WebView适配配置
  'appium:chromeOptions': {
    androidPackage: 'com.android.webview', // 替换为你的WebView所属包名
    androidUseRunningApp: true,
    excludeSwitches: ['enable-automation']
  },
  'appium:chromedriverExecutableDir': './node_modules/appium-chromedriver/chromedriver/mac' // 对应你的系统路径
}]

注意：需保证Chromedriver版本与设备WebView的Chrome版本完全匹配（可通过adb shell dumpsys package com.android.webview查看WebView版本）。

4. 修复POST操作中止错误 #

自定义方法报错通常是因为WebView进程未完全就绪，添加重试与等待逻辑：

async function switchToWebViewWithRetry(packageName, maxRetries = 3) {
  let retryCount = 0;
  while (retryCount < maxRetries) {
    try {
      const contexts = await driver.getContexts();
      const targetContext = contexts.find(ctx => ctx.includes(`WEBVIEW_${packageName}`));
      if (targetContext) {
        await driver.switchContext(targetContext);
        // 验证切换成功：执行Web端操作确认
        await driver.executeScript('return document.title');
        return;
      }
    } catch (err) {
      retryCount++;
      await driver.pause(2000); // 等待2秒后重试
    }
  }
  throw new Error(`重试${maxRetries}次后仍无法切换到WebView上下文`);
}

5. Android15专属适配 #

Android15新增WebView调试权限限制，需在AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.DEBUG_WEBVIEW" />

若应用targetSdk>=34，需在启动时动态申请权限：

// MainActivity中添加权限申请逻辑
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.DEBUG_WEBVIEW)
        != PackageManager.PERMISSION_GRANTED) {
        registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
            // 处理权限申请结果
        }.launch(Manifest.permission.DEBUG_WEBVIEW)
    }
}

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