在Appium开展Android自动化测试时，ADB作为连接测试框架和Android设备的核心桥梁，其命令执行的稳定性直接影响测试流程的推进。一旦出现ADB执行超时，往往会抛出adb_exec_timeout相关的报错，导致测试任务中断，需要针对性排查解决。
一、ADB执行超时的常见表现
ADB执行超时在Appium中通常有明确的报错提示，最常见的报错信息包含以下内容：
- 提示
adb_exec_timeout相关错误，说明ADB命令在设定的时间内没有执行完成 - 部分操作如安装应用、获取设备信息、点击操作等待响应时直接抛出超时异常
- 偶现性的超时，同一套测试用例有时能跑通有时失败，没有固定的复现规律
二、问题排查步骤
1. 基础环境与连接排查
首先确认ADB服务和设备连接的基础状态，这是最常见的问题诱因：
- 执行
adb devices命令，查看设备是否正常连接，设备状态是否为device，如果显示为offline或者没有设备信息，先排查USB连接或者无线调试配置 - 重启ADB服务，执行以下命令重置ADB状态：
# 关闭ADB服务 adb kill-server # 启动ADB服务 adb start-server # 再次查看设备连接状态 adb devices
2. Appium配置参数排查
Appium本身有ADB执行超时的默认配置，如果执行的命令本身耗时较长，默认配置可能不够用：
- 检查Appium的
adbExecTimeout参数，默认值是20000毫秒也就是20秒，如果执行的命令比如安装大型应用、获取复杂页面结构耗时超过这个值就会触发超时 - 确认是否配置了错误的ADB路径，导致Appium调用的ADB版本和设备不匹配，出现执行卡顿
3. 命令与设备性能排查
部分场景下是命令本身或者设备性能导致执行慢：
- 单独手动执行超时的ADB命令，看是否需要很长时间才能完成，比如
adb shell uiautomator dump获取页面结构，如果设备卡顿执行耗时超过30秒，就需要优化命令或者提升设备性能 - 检查设备剩余存储空间，存储空间不足时ADB执行安装、文件操作类命令会变慢甚至超时
三、对应解决方案
1. 调整Appium超时配置
如果确认是默认超时时间不足，可以在Appium的Desired Capabilities中调大adbExecTimeout的值，比如设置为60000毫秒也就是60秒：
from appium import webdriver
desired_caps = {
"platformName": "Android",
"deviceName": "test_device",
"appPackage": "com.example.app",
"appActivity": ".MainActivity",
# 设置ADB执行超时时间为60秒
"adbExecTimeout": 60000
}
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)
2. 优化ADB执行环境
针对ADB服务和设备连接的问题，可以采取以下措施：
- 如果是无线调试场景，尽量保证设备和服务端在同一个局域网，减少网络延迟
- 定期清理设备的后台进程，避免设备卡顿导致ADB命令执行变慢
- 如果使用的是模拟器，尽量分配足够的CPU和内存资源，避免模拟器性能不足
3. 拆分复杂命令
对于耗时较长的ADB命令，可以尝试拆分执行，避免长时间占用ADB通道：
比如原本一次性获取整个页面的UI结构耗时很久，可以分区域获取，或者减少不必要的UI结构获取频率，从业务层面优化执行逻辑。
四、预防超时的注意事项
- 不要在测试过程中频繁执行高耗时的ADB命令，比如每次操作都获取完整页面结构
- 定期更新ADB到稳定版本，避免旧版本ADB存在的性能问题
- 对于稳定性较差的测试设备，可以适当预留更多的超时时间，同时增加重试机制
通过以上排查步骤和解决方案，基本可以覆盖大部分Appium ADB执行超时的问题场景，开发者可以根据实际报错情况逐步定位，快速恢复测试流程。
AppiumADBadb_exec_timeoutAndroid自动化timeout修改时间：2026-07-01 06:15:27