Appium启动失败主因是adb未配置或设备未授权；需检查SDK路径、USB调试、驱动及手动授权；模拟器推荐x86_64镜像；客户端配置须platformName小写、用UiAutomator2、设noReset和超时参数；定位优先用accessibility_id或id，慎用XPath。
Appium服务启动失败：adb未找到或设备不识别
Appium依赖adb与真机/模拟器通信，常见报错是Could not find adb或No device found。根本原因不是Appium装得不对，而是Android SDK路径没进系统环境变量，或者USB调试没开、驱动没装（Windows尤其容易卡在这儿）。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确认
adb命令能在终端直接运行；不行就手动把platform-tools路径加到PATH里（比如/Users/xxx/Library/Android/sdk/platform-tools） - 用
adb devices看输出——如果显示unauthorized，说明手机弹窗没点“允许”，重启adb也不行，必须手动点授权 - 模拟器推荐用Android Studio自带的
Pixel_4_API_30（x86_64），别用ARM镜像，慢且常兼容异常；启动后等状态栏出现信号格再连Appium - Appium Desktop里启动服务器前，先勾选
Allow Proxy和Use External ADB（指向你本地的adb），避免它自己带的adb版本太旧
Python客户端连不上Appium：desired_caps配置错在哪
连不上最常踩的坑是platformName写成Android（首字母大写）但实际要求全小写android，或者appPackage/appActivity填的是主界面名而非启动Activity。Appium不报语法错，只返回SessionNotCreatedException，让人摸不着头脑。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
adb shell dumpsys window | grep -E 'mCurrentFocus|mFocusedApp'抓当前前台Activity，确保appActivity值带完整包名，比如com.xxx.app/.MainActivity -
deviceName不用硬写手机型号，填emulator-5554（模拟器端口）或any更稳妥；automationName固定用UiAutomator2，别用默认的Appium（已弃用） - 首次运行加
noReset: False，否则App被清数据，登录态没了还得手动输验证码 - 超时参数必设：
newCommandTimeout: 60，不然空闲30秒自动断连，脚本跑一半就挂
定位元素总失败：XPath在移动端根本不可靠
写//TextView[@text='登录']看着很直观，但Appium对XPath支持弱，尤其遇到动态ID、多层嵌套或React Native渲染的组件，基本一试一个不灵。错误现象是NoSuchElementException，但元素明明在界面上。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 优先用
accessibility_id（对应UI里的content-desc），iOS叫name，稳定又快；没有就用id（resource-id），比如driver.find_element_by_id('com.xxx:id/btn_login') - 实在要XPath，别写绝对路径，用
contains(@text, '登录')代替精确匹配，加index限定范围，比如(//android.widget.Button)[1] - 用Appium Desktop的Inspector实时刷新页面结构，别信开发给的“这个ID永远不变”——热更新一发，ID就变
- WebView混合页？先
driver.contexts切到WEBVIEW_...，再用find_element_by_css_selector，别在原生上下文里硬找HTML元素
模拟器里App打不开：APK签名或架构不匹配
Appium报Cannot start the 'app' application，但adb install xxx.apk却成功，大概率是APK用了V2/V3签名，而老版模拟器（API arm64-v8a，但模拟器是x86_64，直接拒载。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
apksigner verify -v xxx.apk看签名方案，若显示Verified using v1 scheme (JAR signing): false，说明只用了V2/V3，得让开发补V1签名，或换API 26+模拟器 - 查APK支持的ABI：
aapt dump badging xxx.apk | grep native-code，输出含x86_64才配x86模拟器；不含就只能换ARM模拟器（慢）或重打包 - Appium Desktop里不要勾
Auto Grant Permissions，有些权限（如ACCESS_BACKGROUND_LOCATION）Android 10+必须手动点，脚本里用adb shell pm grant提前授 - 真机测试前，先关掉开发者选项里的
MIUI优化（小米）、纯净后台（华为），否则App秒退，日志里连堆栈都不留
移动端自动化真正的难点不在代码怎么写，而在每次App更新后，resource-id、activity路径、WebView注入时机、甚至模拟器系统镜像版本，都可能悄无声息地断掉整个链路。留好adb logcat日志截断点，比写一百行等待逻辑都管用。
