Appium启动失败主因是ADB环境未配好或设备未授权；新版需用AppiumOptions替代DesiredCapabilities；定位优先ID或ACCESSIBILITY_ID；双端脚本应抽离平台差异。
Appium服务端启动失败：adb找不到或设备不识别
Appium本身不操作手机，它靠adb和xcodebuild桥接设备；安卓端第一步就卡住，八成是环境没对齐。
常见错误现象：adb: command not found、No device found、device unauthorized。
- 确保
ANDROID_HOME指向SDK根目录（不是platform-tools），且platform-tools在PATH里 - 用
adb devices确认设备在线——真机要开“开发者选项”+“USB调试”，模拟器启动后等几秒再查 - 出现
unauthorized时，拔插USB、点手机弹窗“允许USB调试”，别勾“始终允许”（会失效） - Mac上M1/M2芯片运行x86模拟器可能触发
adb架构冲突，优先用ARM64镜像或Android Studio自带的emulator命令启动
Python客户端连不上Appium：DesiredCapabilities过时与driver初始化踩坑
新版Appium（v2.0+）弃用DesiredCapabilities字典传参，硬套老教程会直接抛SessionNotCreatedException。
使用场景：用appium-python-client 2.x+ 连接本地Appium Server（默认http://127.0.0.1:4723）。
立即学习“Python免费学习笔记（深入）”；
- 改用
AppiumOptions对象设置参数：options = AppiumOptions()→options.set_capability('platformName', 'Android') -
appPackage和appActivity必须准确——用adb shell dumpsys window | grep mCurrentFocus抓前台包名，别手写错大小写 - iOS需额外配
udid、platformVersion、deviceName，且Xcode必须已信任该设备（xcode-select --install+ 手动信任） - 连接超时默认仅60秒，真机冷启动App慢时加
options.set_capability('newCommandTimeout', 180)
from appium import webdriver
from appium.options.common import AppiumOptions
options = AppiumOptions()
options.set_capability('platformName', 'Android')
options.set_capability('appPackage', 'com.example.app')
options.set_capability('appActivity', '.MainActivity')
driver = webdriver.Remote('http://127.0.0.1:4723', options=options)
定位元素总失败：id/class_name/xpath在不同App和系统版本表现不一致
安卓上resource-id最稳，但iOS的name或label字段常为空；用xpath看似灵活，实则一升级就断，尤其带索引的//android.widget.Button[1]。
性能影响：xpath解析比id慢3–5倍，连续调用易触发Appium响应延迟。
- 优先用
driver.find_element(By.ID, 'com.example:id/login_btn')（安卓）或By.ACCESSIBILITY_ID（iOS通用） - 避免用
find_elements取列表再[0]，改用find_element直接抛异常——更早暴露定位问题 - 动态内容（如时间戳ID）用contains匹配：
By.XPATH, "//*[@resource-id[contains(., 'btn_')]]" - WebView页内控件需先
driver.contexts切到WEBVIEW_上下文，否则永远找不到
安卓/iOS双端脚本维护成本高：如何收敛差异逻辑
同一业务流程，在安卓调press_keycode(4)返回，在iOS得driver.execute_script('mobile: backdoor', {'action': 'goBack'})——硬写两套代码等于自找麻烦。
容易被忽略的点：iOS的bundleId和安卓的appPackage不能共用一个变量名混着传，driver初始化阶段就报错。
- 把平台相关参数抽成配置字典：
caps = {'Android': {...}, 'iOS': {...}}，根据platform_name动态加载 - 封装基础操作函数，内部判断平台：
def click_back(driver): if 'Android' in driver.capabilities['platformName']: driver.press_keycode(4) else: driver.execute_script('mobile: backdoor', ...) - 截图路径按平台分目录：
screenshots/android/vsscreenshots/ios/，避免覆盖或权限报错 - CI跑双端时，别共用一个Appium Server实例——iOS需macOS环境且占用端口，建议用Docker Compose起两个独立服务
