企业官网建设流程全解析

Appium 3.x 安卓APP自动化踩坑记录：从启动报错到成功运行（附完整代码）

前言

本文为个人学习Appium移动端自动化的实战踩坑记录，完整记录了从环境搭建到跨应用启动APP过程中遇到的4类典型报错，以及对应的排查思路和最终解决方案。全程基于Appium 3.x最新版本，适配安卓9/15系统，适合新手入门避坑参考。

本文为个人原创学习笔记，所有代码均为本人实操验证；Appium为开源项目，遵循Apache 2.0开源协议，本文仅作技术学习交流，无商业用途。

一、环境版本清单

本次实操的完整环境栈如下，所有报错均基于该环境复现与修复：

二、踩坑全记录与解决方案

报错1：AttributeError: ‘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全路径"})

报错2：unrecognized object token shape

报错信息

Original error: 'unrecognized object token shape'

原因分析

新版UiAutomator2驱动不支持嵌套intent字典的传参格式，多层对象解析失败；平铺传参时也会出现activity字段丢失的兼容问题。

解决方案

1. 优先使用mobile: shell直接执行adb命令，绕开参数解析逻辑；
2. 若坚持使用mobile: startActivity，改用component字段一次性指定包名+Activity：

driver.execute_script("mobile: startActivity",{"component":"包名/Activity全路径"})

报错3：SecurityException: Permission Denial: not exported

报错信息

java.lang.SecurityException: Permission Denial: starting Intent ... not exported from uid 10056

原因分析

安卓12+系统强制安全规则：目标Activity在应用清单中设置了android:exported="false"，不允许第三方程序（adb、其他应用）直接启动，绝大多数应用的内部业务页面都默认关闭导出权限。

解决方案

两种合规绕开方式，按需选择：

1. monkey命令启动（推荐）：模拟用户桌面点击，自动匹配应用的官方启动页，天然避开权限限制

driver.execute_script("mobile: shell",{"command":"monkey -p 包名 -c android.intent.category.LAUNCHER 1"})

2. 初始化直接打开目标应用：在能力集caps中直接填写目标应用包名，Appium原生启动，不触发跨应用权限拦截

caps={"appium:appPackage":"目标应用包名",# 可不填appActivity，Appium自动解析启动页}

报错4：Potentially 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,}# 加载能力集，创建驱动options=AppiumOptions()options.load_capabilities(caps)driver=webdriver.Remote(command_executor='http://127.0.0.1:4723',options=options)# 跳转至目标应用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()

运行前置条件

1. 启动Appium服务时使用appium --relaxed-security命令；
2. 模拟器/真机已开启USB调试，且adb连接正常；
3. 目标应用已安装在设备中，包名与Activity名称正确。

四、小白避坑总结

1. 不要死磕老教程的API：Appium 3.x 与 1.x/2.x 的API差异很大，遇到方法不存在优先查新版官方文档，不要硬套旧代码。
2. 先验证底层命令，再写脚本：所有启动、跳转操作，先在cmd里用adb命令验证是否可行，排除应用本身的权限、名称问题。
3. 高版本安卓权限更严：安卓12+的exported限制是系统规则，不是模拟器或Appium的bug，换模拟器也解决不了，换启动方式才是正解。
4. 环境统一是关键：模拟器自带的adb与SDK的adb版本必须一致，否则会出现设备频繁掉线、命令偶发失败的玄学问题。

五、版权与参考说明

1. 本文为个人原创学习笔记，代码与内容均为本人整理实操，发布于CSDN仅作技术交流；
2. Appium 为开源自动化测试框架，遵循 Apache 2.0 开源协议，本文引用其官方安全规范仅作学习说明；
3. 转载请注明原文出处，禁止商用；
4. 参考资料：Appium 官方安全文档