使用Appium与WebdriverIO进行移动端应用测试：解决“/session路由未找到”问题

我之前也碰到过一模一样的问题，这个错误本质是WebdriverIO客户端和Appium服务器的会话创建失败，大概率是配置不匹配、通信异常或者环境兼容性问题导致的。咱们一步步来排查修复：

1. 先确认Appium服务器的通信基础 #

这个错误首先要检查客户端和服务器的端口、状态是否对齐：

• 核对端口：你配置里写的port: 4723是Appium默认端口，启动Appium时要确保日志里显示[Appium] Appium REST http interface listener started on 0.0.0.0:4723。如果Appium启动时用了其他端口，要么改启动命令加--port 4723，要么修改wdio配置里的port值。
• 检查端口占用：用lsof -i :4723（Mac/Linux）或netstat -ano | findstr :4723（Windows）确认4723端口没被其他进程占用，有占用的话杀掉对应进程再重启Appium。
• 等待服务器就绪：一定要等Appium日志输出[Appium] Ready to accept connections后，再执行npm run android.app，服务器没启动完全就跑测试肯定会报错。

2. 修正Android Capabilities的关键配置 #

你的capabilities里有几个容易踩坑的点，直接影响会话创建：

• 更换自动化驱动：Android 10（API 29）版本不建议用旧的Appium（UiAutomator1）驱动，把'appium:automationName': 'Appium'改成'appium:automationName': 'UiAutomator2'，同时执行appium driver install uiautomator2安装对应驱动（如果是Appium 2.x版本）。
• 验证应用路径：确认./apps/Android-NativeDemoApp-0.2.1.apk的路径绝对正确，在项目根目录执行ls ./apps/（Mac/Linux）或dir .\apps\（Windows）检查文件是否存在，路径错误会导致Appium找不到应用，直接中断会话创建。
• 核对设备UDID：执行adb devices命令，确保输出的模拟器ID和capabilities里的'appium:udid': 'emulator-5554'完全一致，模拟器重启后UDID可能会变化。

3. 检查版本兼容性 #

版本不兼容是隐形大坑：

• 查看package.json里的webdriverio和@wdio/appium-service版本，确保和你安装的Appium服务器版本匹配：Appium 2.x需要搭配WebdriverIO 8.x；Appium 1.x则对应WebdriverIO 7.x及以下版本。
• 如果用Appium 2.x，必须手动安装所需驱动（比如uiautomator2），不能依赖默认配置。

4. 调整测试执行的前置步骤 #

确保操作顺序完全正确：

1. 先启动Android模拟器，等待模拟器完全加载到桌面界面（状态稳定，不要刚启动就跑测试）。
2. 手动在模拟器上安装测试应用，确认能正常打开——如果应用本身安装失败或打不开，测试肯定跑不起来。
3. 启动Appium服务器，等待就绪后再执行测试命令。

5. 开启详细日志定位细节 #

把wdio配置里的logLevel: 'silent'改成logLevel: 'debug'，重新运行测试，终端会输出WebdriverIO和Appium的完整通信日志，能看到会话创建时的具体错误（比如应用安装失败、权限问题等），更容易精准修复。

内容的提问来源于stack exchange，提问作者Tomas