1. Windows 下 Appium Python Client 连接夜神模拟器为什么总卡在 adb 这一步如果你正在 Windows 上折腾 Appium Python Client 夜神模拟器大概率会遇到一个非常经典的报错adb server version (31) does not match this client (36)。这个报错的本质是——夜神模拟器自带的nox_adb.exe版本比 Android SDKplatform-tools目录下的adb.exe版本低两个 adb 服务在同一个端口上抢着干活谁都不服谁。Appium 本身是一个 HTTP 服务它通过 adb 跟模拟器里的设备通信。Python Client 只是把测试脚本翻译成 WebDriver 协议请求发给 Appium。所以整条链路是Python 脚本 → Appium Server默认 4723 端口→ adb → 夜神模拟器里的 Android 系统。只要 adb 这一环断了后面 Desired Capabilities 配得再漂亮也建不了 session。这篇内容适合三类人刚接触移动端自动化的测试同学、想把夜神模拟器接进 CI 流程的开发者、以及被 adb 版本冲突折磨过想找一份可复制配置的人。我会把 adb 版本对齐、设备连接、config.toml 骨架、Python 启动会话验证、以及统一 Key 通道接入这几件事串成一条能直接跑的链路。实测下来只要 adb 版本对齐 端口连对一次跑通的概率非常高。2. 前置准备TaoToken 统一 Key 与 API 通道接入在写自动化脚本之前先把模型调用这条线理清楚。很多同学做 Appium 自动化时脚本里会嵌入一些智能断言、元素语义识别、或者失败截图后的多模态分析这些都需要调模型 API。如果每个项目都单独申请 Key、单独配 base_url维护成本会很高。TaoToken 的思路是提供一个统一的 API 通道你只需要一个 Key就能在多个模型之间切换。对于 Appium 自动化这种场景比较实用的用法是把失败用例的截图 页面层级 dump 一起发给模型让它判断是元素定位失效还是页面加载超时。你可以先到官网了解整体能力https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 然后在控制台创建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Key 创建后建议单独放一个环境变量文件不要硬编码进 Python 脚本。API 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数。如果你用的是 OpenAI 兼容的 SDK把base_url指向它即可。接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言的最小请求示例。注意Key 属于敏感凭证建议用.envpython-dotenv的方式加载提交代码前确认.env已在.gitignore里。3. 可复制配置adb 版本对齐 config.toml 骨架3.1 解决 adb 版本冲突先关掉夜神模拟器然后打开任务管理器确认adb.exe和nox_adb.exe两个进程都已经结束。接着做文件替换# 假设 SDK 路径和夜神路径如下按你本机实际路径调整 # SDK: C:\Program Files (x86)\Android\android-sdk\platform-tools # 夜神: C:\Program Files (x86)\Nox\bin # 1. 备份夜神自带的 adb ren C:\Program Files (x86)\Nox\bin\adb.exe adb_bak.exe ren C:\Program Files (x86)\Nox\bin\nox_adb.exe nox_adb_bak.exe # 2. 把 SDK 的 adb 复制过去 copy C:\Program Files (x86)\Android\android-sdk\platform-tools\adb.exe C:\Program Files (x86)\Nox\bin\adb.exe # 3. 再复制一份改名成 nox_adb.exe让夜神调用时也走新版 copy C:\Program Files (x86)\Android\android-sdk\platform-tools\adb.exe C:\Program Files (x86)\Nox\bin\nox_adb.exe替换完成后重新启动夜神模拟器再执行连接命令cd C:\Program Files (x86)\Nox\bin nox_adb.exe connect 127.0.0.1:62001 adb devices如果输出里出现127.0.0.1:62001 device说明设备已经识别成功。夜神默认的 adb 端口是 62001多开时依次是 62025、62026 等具体以你模拟器设置里显示的为准。3.2 config.toml 骨架把 Appium 连接参数和模型 Key 统一放进一个配置文件脚本里只读配置不写死。下面这份骨架可以直接复制# config.toml [appium] server_url http://127.0.0.1:4723/wd/hub platform_name Android platform_version 7.1.2 device_name 127.0.0.1:62001 app_package com.example.demo app_activity com.example.demo.MainActivity no_reset true new_command_timeout 300 [taotoken] base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY default_model claude-sonnet [timeout] implicit_wait 10 explicit_wait 20Python 侧读取配置import os import toml from dotenv import load_dotenv load_dotenv() cfg toml.load(config.toml) api_key os.getenv(cfg[taotoken][api_key_env]) base_url cfg[taotoken][base_url]platform_version一定要跟夜神模拟器里「设置 → 关于平板电脑」显示的 Android 版本一致写错了 Appium 会直接拒绝建 session。device_name填adb devices里看到的那个地址不要填模拟器窗口标题。4. 验证请求一次启动会话 模型调用4.1 启动 Appium Server命令行方式启动最省事appium --address 127.0.0.1 --port 4723 --log-level info看到Appium REST http interface listener started on 127.0.0.1:4723就说明服务起来了。如果你用 Appium Desktop默认 host 和 port 跟上面一致点 Start Server 即可。4.2 Python Client 建会话from appium import webdriver from appium.options.android import UiAutomator2Options import toml cfg toml.load(config.toml)[appium] options UiAutomator2Options() options.platform_name cfg[platform_name] options.platform_version cfg[platform_version] options.device_name cfg[device_name] options.app_package cfg[app_package] options.app_activity cfg[app_activity] options.no_reset cfg[no_reset] options.new_command_timeout cfg[new_command_timeout] driver webdriver.Remote(cfg[server_url], optionsoptions) print(session id:, driver.session_id) print(current activity:, driver.current_activity) driver.quit()跑通后你会看到 session id 和当前 Activity 被打印出来这就证明 Python Client → Appium → adb → 夜神这条链路是通的。如果卡在建 session 阶段先回到第 3 步确认adb devices能列出设备。4.3 用统一 Key 做一次模型调用验证import os from openai import OpenAI import toml cfg toml.load(config.toml)[taotoken] client OpenAI( api_keyos.getenv(cfg[api_key_env]), base_urlcfg[base_url], ) resp client.chat.completions.create( modelcfg[default_model], messages[ {role: user, content: 用一句话说明 Appium 建 session 失败时优先检查什么} ], ) print(resp.choices[0].message.content)这段能返回内容说明 Key 和 API 通道是通的。后续你可以把 Appium 失败截图转成 base64 塞进 messages让模型帮你判断页面状态。想直接在网页里试模型效果可以用模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。5. 本篇常见错排查5.1 adb server version 不匹配报错原文类似adb server version (31) does not match this client (36); killing...。根因就是两个 adb 版本不一致。按 3.1 节做文件替换替换后务必重启模拟器否则旧进程还在内存里跑。替换完执行adb kill-server adb start-server再adb devices。5.2 adb devices 列表为空先确认夜神模拟器已经完全启动到桌面不是卡在开机动画。然后手动执行nox_adb.exe connect 127.0.0.1:62001。如果提示cannot connect to 127.0.0.1:62001检查端口是否被占用或者模拟器是不是多开实例端口会变。还有一种情况是 Windows 防火墙拦了 adb 的本地回环连接临时关掉防火墙测试一下。5.3 Appium 建 session 报 platformVersion 不匹配夜神的 Android 版本在「设置 → 关于平板电脑」里看常见是 7.1.2 或 9。platform_version写错会报No device found或The desired capabilities are not supported。另外device_name必须跟adb devices输出完全一致包括127.0.0.1:62001这种带端口的格式。5.4 元素定位不到Appium 的定位方式跟 Selenium 有区别。find_element_by_id对应的是resource-idfind_element_by_class_name对应classfind_element_by_accessibility_id对应content-desc。xpath 下标从 1 开始不是 0。建议先用 Appium Inspector 连上设备把页面层级 dump 出来再写定位表达式比盲猜快很多。5.5 模型调用返回 401先确认环境变量TAOTOKEN_API_KEY真的被加载了可以在脚本里print(api_key[:8])看前几位。再确认base_url是https://taotoken.net/api不要多加/v1或结尾斜杠。如果还是 401去控制台重新生成一个 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。6. 把这条链路固定下来adb 版本对齐这件事建议做成一个初始化脚本每次换机器或重装模拟器后跑一遍比手动复制文件可靠。config.toml 里的device_name和platform_version是最容易写错的两个字段建议在脚本启动时先做一次adb devices校验设备不在线就直接退出并打印提示而不是等 Appium 报一堆看不懂的错。如果你后面要把这套自动化接到长期跑的编码任务或 Agent 流程里可以考虑用 Coding Plan 来统一管理调用额度https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Claude Code 相关的接入方式在 Anthropic 通道文档里有说明https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个我踩过的坑夜神模拟器升级后bin目录下的nox_adb.exe会被覆盖回旧版本之前做的替换会失效。所以每次模拟器大版本更新后重新跑一遍 3.1 节的替换命令再adb devices确认一次能省掉很多莫名其妙的建 session 失败。