Appium 3.x 安卓APP自动化踩坑记录从启动报错到成功运行附完整代码前言本文为个人学习Appium移动端自动化的实战踩坑记录完整记录了从环境搭建到跨应用启动APP过程中遇到的4类典型报错以及对应的排查思路和最终解决方案。全程基于Appium 3.x最新版本适配安卓9/15系统适合新手入门避坑参考。本文为个人原创学习笔记所有代码均为本人实操验证Appium为开源项目遵循Apache 2.0开源协议本文仅作技术学习交流无商业用途。一、环境版本清单本次实操的完整环境栈如下所有报错均基于该环境复现与修复组件版本检查命令Node.jsv22.12.0node -vAppium Server3.5.2appium --versionAndroid SDKplatform-tools 已配置adb versionJava JDK21.0.11java -versionPython3.11.9python --versionAppium-Python-Client5.xpip show Appium-Python-Client测试设备雷电模拟器9安卓9adb devices二、踩坑全记录与解决方案报错1AttributeError: ‘WebDriver’ object has no attribute ‘start_activity’报错信息AttributeError: WebDriver object has no attribute start_activity. Did you mean: wait_activity?原因分析Appium-Python-Client 5.x 版本已移除start_activity()直接方法该API在旧版4.x中存在新版进行了API重构不再支持直接调用。解决方案放弃原生方法改用mobile: shell执行adb命令启动应用兼容性更强不受客户端版本影响driver.execute_script(mobile: shell,{command:am start -n 包名/Activity全路径})报错2unrecognized object token shape报错信息Original error: unrecognized object token shape原因分析新版UiAutomator2驱动不支持嵌套intent字典的传参格式多层对象解析失败平铺传参时也会出现activity字段丢失的兼容问题。解决方案优先使用mobile: shell直接执行adb命令绕开参数解析逻辑若坚持使用mobile: startActivity改用component字段一次性指定包名Activitydriver.execute_script(mobile: startActivity,{component:包名/Activity全路径})报错3SecurityException: Permission Denial: not exported报错信息java.lang.SecurityException: Permission Denial: starting Intent ... not exported from uid 10056原因分析安卓12系统强制安全规则目标Activity在应用清单中设置了android:exportedfalse不允许第三方程序adb、其他应用直接启动绝大多数应用的内部业务页面都默认关闭导出权限。解决方案两种合规绕开方式按需选择monkey命令启动推荐模拟用户桌面点击自动匹配应用的官方启动页天然避开权限限制driver.execute_script(mobile: shell,{command:monkey -p 包名 -c android.intent.category.LAUNCHER 1})初始化直接打开目标应用在能力集caps中直接填写目标应用包名Appium原生启动不触发跨应用权限拦截caps{appium:appPackage:目标应用包名,# 可不填appActivityAppium自动解析启动页}报错4Potentially insecure feature ‘adb_shell’ has not been enabled报错信息Potentially insecure feature adb_shell has not been enabled.原因分析Appium 3.x 出于安全考虑默认禁用了adb_shell高危功能防止未授权的shell命令执行本地学习使用需要手动开启。解决方案启动Appium服务时添加安全放宽参数一劳永逸开启所有本地调试功能# 替换原来的 appium 启动命令appium --relaxed-security注意该参数仅适合本地开发学习使用生产环境、公网部署的Appium服务请勿开启避免安全风险。三、最终成功运行完整代码以下代码经过实操验证可直接复制运行实现「先打开系统设置再跳转至目标应用」的效果。importtimefromappiumimportwebdriverfromappium.options.commonimportAppiumOptions# 配置参数caps{platformName:Android,appium:platformVersion:9,appium:deviceName:127.0.0.1:5555,appium:automationName:UiAutomator2,appium:appPackage:com.android.settings,appium:appActivity:com.android.settings.Settings,appium:noReset:True,}# 加载能力集创建驱动optionsAppiumOptions()options.load_capabilities(caps)driverwebdriver.Remote(command_executorhttp://127.0.0.1:4723,optionsoptions)# 跳转至目标应用driver.execute_script(mobile: shell,{command:am start -n com.android.flysilkworm/com.android.flysilkworm.app.activity.FrameworkActivity})# 等待应用加载完成time.sleep(3)# 打印当前页面信息验证跳转成功print(f当前包名{driver.current_package})print(f当前Activity{driver.current_activity})driver.quit()运行前置条件启动Appium服务时使用appium --relaxed-security命令模拟器/真机已开启USB调试且adb连接正常目标应用已安装在设备中包名与Activity名称正确。四、小白避坑总结不要死磕老教程的APIAppium 3.x 与 1.x/2.x 的API差异很大遇到方法不存在优先查新版官方文档不要硬套旧代码。先验证底层命令再写脚本所有启动、跳转操作先在cmd里用adb命令验证是否可行排除应用本身的权限、名称问题。高版本安卓权限更严安卓12的exported限制是系统规则不是模拟器或Appium的bug换模拟器也解决不了换启动方式才是正解。环境统一是关键模拟器自带的adb与SDK的adb版本必须一致否则会出现设备频繁掉线、命令偶发失败的玄学问题。五、版权与参考说明本文为个人原创学习笔记代码与内容均为本人整理实操发布于CSDN仅作技术交流Appium 为开源自动化测试框架遵循 Apache 2.0 开源协议本文引用其官方安全规范仅作学习说明转载请注明原文出处禁止商用参考资料Appium 官方安全文档