为什么Python调用Appium进行手机端自动化时总是连接超时？-Python教程-PHP中文网

根本原因是appium server未真正监听请求，常见于gui未点“start server”、命令行漏配--address/--port导致绑定错误、防火墙拦截4723端口、手机与pc不在同一局域网或usb调试未正确配置。

为什么python调用appium进行手机端自动化时总是连接超时？

Appium Server 启动后 `driver = webdriver.Remote()` 一直卡住或报错 `ConnectionRefusedError`

根本原因通常是 Appium Server 没真正监听到请求，而不是代码写错了。常见情况是：你双击了 Appium Desktop 图标启动 GUI，但没点「Start Server」按钮；或者用命令行启动时漏了 --address 和 --port，导致默认绑定在 127.0.0.1:4723，而手机和 PC 不在同一网段（比如手机连的是 WiFi，PC 走的是有线网）。

实操建议：

Shadows Python Sensei

Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载

用命令行启动更可控：appium --address 0.0.0.0 --port 4723 --allow-insecure=adb_shell（0.0.0.0 表示监听所有网卡，不是只限本地）
确认 PC 的防火墙放行了 4723 端口（Windows Defender 或 macOS 防火墙都可能拦截）
手机和 PC 必须在同一局域网；如果用 USB 调试，确保已执行 adb tcpip 5555 并用 adb connect 192.168.x.x:5555 连上，否则 Remote() 仍会尝试走 WiFi
Python 端的 command_executor 地址必须和 Server 实际监听地址一致，例如："http://192.168.1.100:4723/wd/hub"，别硬写 localhost

连接成功后，`driver.find_element()` 超时，日志显示 `Waiting for condition` 却一直等不到元素

这不是网络问题，而是 Appium 没拿到页面源树（source tree），常见于目标 App 未就绪、Activity 未正确启动，或 Android/iOS 权限没开全。

实操建议：

先手动在手机上打开目标 App，确认能正常进入首页；再看 Appium 日志里有没有 Failed to start an Appium session 或 Could not find adb
Android 必须开启「USB 调试」和「USB 安装」，部分厂商（华为、小米）还要额外打开「MTP/文件传输模式」和「允许模拟点击」权限
检查 desired_caps 中的 appPackage 和 appActivity 是否准确——用 adb shell dumpsys activity activities | grep mResumedActivity 查当前 Activity，别依赖网上抄的过期配置
加个显式等待再找元素：WebDriverWait(driver, 10).until(EC.presence_of_element_located((By.ID, "xxx")))，避免直接调 find_element 导致默认 0 秒超时

同一套代码，在 Windows 上跑通，Mac 上总提示 `socket.timeout: timed out`

大概率是 Mac 上的 adb 版本和 Appium 内置的不兼容，或者 ANDROID_HOME 环境变量没生效，导致 Appium 找不到设备或无法推送 bootstrap apk。

实操建议：

在终端运行 which adb，确认输出路径；然后在 Appium Desktop 的「Preferences → General → Android SDK Root」里填入同一路径（不能只填 ~/Library/Android/sdk，要展开成绝对路径如 /Users/xxx/Library/Android/sdk）
删掉 ~/.appium/appium-doctor 缓存，重启 Appium Server
Mac 上禁用 SIP（System Integrity Protection）不会影响 Appium，但某些安全软件（如 Little Snitch）会拦截 adb 的 socket 连接，临时关闭试试
换用 appium@2.0+ + appium-uiautomator2-driver 组合，旧版 uiautomator 在 M1/M2 Mac 上容易挂

真机连上后，`driver.get_screenshot_as_file()` 失败，日志报 `io.appium.uiautomator2.common.exceptions.InvalidElementStateException`

这通常不是截图函数本身的问题，而是当前上下文（Context）不在 Native App，却强行调用了 Native 层 API。比如 WebView 页面还没切换 Context 就去截屏，或页面正在销毁动画中，UI Automator 树尚未刷新。

实操建议：

截图前先确认当前 Context：print(driver.context)，如果是 WEBVIEW_...，需先 driver.switch_to.context('NATIVE_APP')
避免在 driver.back() 后立刻截图——加个 time.sleep(0.5) 或等 Activity 切换完成（用 driver.current_activity 判断）
真机上截图失败也可能是存储空间不足，adb shell df /data 看下剩余空间；部分国产 ROM（如 OPPO ColorOS）会限制自动化截图，需在「设置 → 安全中心 → 自动化工具权限」里手动开启

Appium 连接超时背后，八成是环境链路断在某个隐性环节：Server 监听地址、ADB 权限、设备网络可达性、Context 状态，而不是代码逻辑本身。调试时优先看 Appium Server 控制台第一行日志是否显示 [Appium] Appium REST http interface listener started on 0.0.0.0:4723，再查 Python 端能否 curl -v http://192.168.x.x:4723/wd/hub/status 通——这比反复改代码有效得多。