1. 问题现象与根源剖析“无法连接到 xxx.xxx.x.xx:5555: 由于目标计算机积极拒绝无法连接。 (10061)”这个错误弹窗对于任何一个需要通过 ADB 调试 Android 设备的开发者或测试人员来说都太熟悉了。它就像一个不请自来的访客总是在你最需要稳定连接的时候出现打断你的调试流程。这个错误的核心信息非常明确你的电脑客户端试图向目标 IP 地址的 5555 端口发起 TCP 连接但对方通常是你的手机或模拟器的 5555 端口根本没有在监听或者明确拒绝了这次连接请求。用更通俗的话说你敲了门但屋里没人或者主人把门锁死了不让你进。错误码 10061 是 Windows 系统网络层面的一个标准错误对应WSAECONNREFUSED。它和 ADB 本身关系不大更多是底层 TCP 协议栈返回的结果。所以当你看到这个错误时首先要明白问题大概率出在“服务端”——也就是你的 Android 设备——的 ADB 调试服务没有正常启动或网络不可达而不是你电脑上的 ADB 客户端命令敲错了。这个问题的诱因可以归结为几个典型场景最常见的是无线调试时手机的 ADB 调试监听端口默认 5555没有打开其次是有线连接时虽然 USB 已连通但设备的 ADB 守护进程adbd可能因为系统休眠、权限变更或冲突而异常再者电脑和手机不在同一个局域网网段或者防火墙包括 Windows Defender 防火墙、第三方安全软件、甚至路由器的安全策略阻断了 5555 端口的通信。每一次连接失败都是一次对开发者网络基础、ADB 工作原理和排查耐心的综合考验。2. ADB 连接模式与通信原理深度解析要彻底解决连接问题必须理解 ADB 是如何工作的。ADB 采用客户端-服务器架构这个“服务器”运行在你的开发电脑上称为 ADB Server进程名为adb.exe。它负责管理所有连接到电脑的 Android 设备无论是通过 USB 还是 TCP/IP并处理来自客户端如 Android Studio、命令行输入的adb命令的请求。设备连接主要有两种模式2.1 USB 调试模式这是最传统、最稳定的方式。当你用数据线连接手机并开启“开发者选项”中的“USB 调试”后手机会启动一个 adbd 守护进程。电脑端的 ADB Server 会通过 USB 驱动与手机的 adbd 建立连接。此时在命令行输入adb devices你会看到设备序列号后面跟着device状态。这种模式下通信完全走 USB 总线不依赖网络所以一般不会出现 10061 错误除非驱动异常、USB 线仅支持充电、或手机端的 adbd 进程崩溃。2.2 网络TCP/IP调试模式这是出现 10061 错误的“重灾区”。该模式又分为两种子情况无线调试Wireless Debugging这是 Android 11 及以上版本官方推荐的方式。在开发者选项中开启“无线调试”后手机会随机开启一个端口如 3xxxx用于配对和调试。你需要先在手机上通过配对码与电脑配对之后 ADB 才会通过一个固定的端口通常是 5555进行常规通信。很多人在配对成功后直接使用adb connect 手机IP:5555如果此时手机的 5555 端口监听未就绪就会立刻触发 10061。从 USB 切换到无线这是一种经典的无线连接方法。先通过 USB 线正常连接设备然后执行adb tcpip 5555命令。这个命令会重启手机上的 adbd并让其监听 5555 端口。拔掉 USB 线后再执行adb connect 手机IP:5555。如果切换不成功或者手机 IP 地址发生变化连接时就会报错。关键在于5555 端口必须在设备的 adbd 进程上处于监听状态。你可以通过在已连接设备的 ADB Shell 中执行netstat -tlnp | grep 5555或getprop service.adb.tcp.port来验证。如果看不到 5555 端口的监听那么任何来自网络的连接尝试都必然失败。3. 系统性排查与解决方案实战面对 10061 错误不要盲目尝试。遵循一个系统性的排查路径可以高效地定位问题。3.1 基础环境检查首先确认最基本的前提条件是否满足开发者选项与 USB 调试确保手机的“开发者选项”已开启并且“USB 调试”开关是打开的。这是所有 ADB 调试的基石。电脑端 ADB 状态在命令行输入adb version确认 ADB 工具已正确安装且版本不过旧。同时检查 ADB Server 是否运行adb start-server。有时杀掉重启一下 Server 能解决玄学问题adb kill-serveradb start-server。USB 连接状态如果使用或有线切换使用原装或高质量的数据线。在电脑的“设备管理器”中检查 Android 设备是否被正确识别为“Android Composite ADB Interface”而不是带有感叹号的未知设备。如果是后者需要安装或更新对应的 USB 驱动。3.2 网络连接专项排查当问题出现在无线连接时网络是首要怀疑对象。确认 IP 地址确保你使用的 IP 地址是手机在当前 Wi-Fi 网络下的内网 IP。在手机的“设置”-“关于手机”-“状态信息”里查看或者连接 Wi-Fi 后点击网络名称查看详情。一个常见陷阱手机可能连接了 2.4GHz 和 5GHz 的双频 Wi-Fi但电脑连接的是另一个频段虽然 SSID 相同但在路由器内部可能属于不同虚拟网络导致无法直连。验证网络互通性在电脑的命令行里使用ping 手机IP。如果能通说明基础网络链路是好的。如果不通问题就在网络配置上需要检查路由器设置、防火墙规则或者尝试将电脑和手机都连接到手机的热点上来排除路由器问题。检查端口监听状态关键步骤这是诊断 10061 的核心。在电脑上使用telnet 手机IP 5555命令。如果端口开放且 adbd 在监听你会看到一个空白窗口或者连接后立即断开因为 adbd 期待的是 ADB 协议数据不是 Telnet 的。如果显示“无法打开到主机的连接... 在端口 5555: 连接失败”那就坐实了 5555 端口未开放。防火墙规则临时关闭电脑的 Windows Defender 防火墙以及任何第三方安全软件的防火墙功能再次尝试连接。如果此时成功说明需要手动在防火墙入站规则中为adb.exe和端口 5555 添加允许规则。3.3 设备端服务状态修复如果网络是通的但端口未开问题就在手机本身。重启 adbd 服务如果有线可用用 USB 线连接手机执行adb usb切换回 USB 模式再执行adb tcpip 5555重新开启网络监听。仔细观察命令输出是否有错误。如果无法有线连接对于 Android 11进入“开发者选项”-“无线调试”先关闭再重新打开。或者使用其提供的“使用配对码配对设备”功能这是最可靠的方式。检查系统设置确保“开发者选项”中的“仅充电模式下允许 ADB 调试”等选项是打开的。有些厂商如华为、小米有额外的“USB 调试安全设置”需要授权或者需要在连接时在手机上点击“允许调试”的弹窗。终极重启重启手机和电脑。这能解决大量因系统状态缓存、进程死锁导致的疑难杂症。3.4 进阶与疑难杂症处理当上述方法都失效时可能需要考虑一些边缘情况。端口占用冲突极少数情况下手机上的其他应用可能占用了 5555 端口。可以通过adb shell netstat -tlnp需要 root 权限查看或者尝试在adb tcpip命令中指定另一个端口如adb tcpip 5556然后使用adb connect 手机IP:5556连接。厂商定制系统限制某些国内手机厂商的深度定制系统如 MIUI、EMUI为了“安全”可能会在后台限制或定时关闭 ADB 网络调试。除了在开发者选项里仔细寻找相关设置如“MIUI 优化”关闭后可能会影响可能需要频繁重复激活操作。ADB 版本兼容性问题确保电脑端的 ADB 版本不是太老。从 Android SDK Platform-Tools 官网下载最新版本替换旧版。使用第三方工具辅助像 Scrcpy、QtScrcpy 这类工具在连接时其内置的 ADB 逻辑有时比手动操作更稳定可以作为一个连接状态的测试手段。4. 标准化操作流程与避坑指南根据我的经验建立一套标准的操作流程能最大程度避免 10061 错误。4.1 无线调试标准化流程Android 11手机和电脑连接到同一个Wi-Fi 网络最好用 5GHz干扰少。手机开启“开发者选项”-“无线调试”。点击“使用配对码配对设备”记下显示的 IP 地址、端口和六位配对码。在电脑命令行执行adb pair 手机IP:配对端口然后根据提示输入配对码。看到“Successfully paired...”表示成功。配对成功后“无线调试”页面会显示一个“已配对的设备”及其 IP 地址和端口通常是:5555。此时再执行adb connect 手机IP:5555。连接成功后adb devices会列出该设备。注意配对pair和连接connect是两个独立的步骤。配对是建立信任关系连接是建立通信通道。很多人只做了第二步所以失败。4.2 USB切换无线标准化流程通用用 USB 线连接手机和电脑确保adb devices能识别到设备状态为device。执行adb tcpip 5555。看到“restarting in TCP mode port: 5555”输出。不要立即拔线。在手机上查看并记录当前的 Wi-Fi IP 地址。执行adb connect 手机IP:5555。看到“connected to ...”输出。此时adb devices列表里应该会有两个条目一个是通过 USB 的一个是通过网络的。现在可以安全地拔掉 USB 线网络连接会继续保持。4.3 常见“坑点”实录坑点一IP地址变更手机在 Wi-Fi 断开重连或切换网络后IP 地址会变。之前成功的adb connect命令就会失效。每次重新连接前务必确认当前 IP。坑点二电脑多网卡如果电脑同时连着有线网卡和无线网卡或者开了 VPNADB 连接请求可能会从错误的网卡发出。可以通过adb -H 电脑本机在手机所在网络的IP connect ...来指定源地址或者暂时禁用不用的网络适配器。坑点三省电策略杀进程手机锁屏或进入深度省电模式后系统可能会挂起或杀死 adbd 进程。需要在手机的“设置”-“电池”-“省电策略”或“应用启动管理”中将“开发者选项”或相关系统进程设为“允许后台活动”。坑点四命令顺序错误一定要先确保 USB 调试模式下设备在线adb devices可见再执行adb tcpip。如果设备不在线tcpip命令找不到目标会静默失败。5. 问题诊断命令速查与脚本化方案当问题出现时一系列命令可以帮助你快速定位瓶颈。我将它们整理成一个诊断流程图和对应的命令集。5.1 诊断命令速查表检查项命令预期结果异常结果与可能原因ADB 服务状态adb start-server无报错或提示 server already running端口 5037 被占用需结束冲突进程设备列表USBadb devices列出设备状态为device列表为空USB未授权/驱动问题设备列表全部adb devices -l显示设备详情包括 transport_id无网络设备信息网络连通性ping 手机IP收到回复延迟稳定请求超时网络不通/IP错误端口可达性telnet 手机IP 5555连接建立空白窗口后自动断开连接失败10061错误端口未监听设备端端口状态adb shell netstat -tln | grep 5555显示tcp 0 0 0.0.0.0:5555 0.0.0.0:* LISTEN无输出adbd未监听TCP端口设备端ADB属性adb shell getprop service.adb.tcp.port输出5555输出为空未设置或-1禁用重置网络调试adb usbadb tcpip 5555输出切换成功信息失败设备未找到/无权限5.2 自动化连接脚本对于需要频繁进行无线调试的场景可以编写一个简单的批处理脚本Windows或 Shell 脚本macOS/Linux来减少手动操作和错误。echo off REM Windows Batch Script: auto_connect_adb.bat echo 正在检查并重启ADB服务... adb kill-server timeout /t 2 /nobreak nul adb start-server timeout /t 2 /nobreak nul echo 请确保手机已通过USB连接并授权... adb devices -l pause echo 正在切换设备至TCP模式端口5555... adb tcpip 5555 if %errorlevel% neq 0 ( echo 错误切换TCP模式失败请检查USB连接和设备授权。 pause exit /b 1 ) echo 请在手机上查看并输入当前的Wi-Fi IP地址 set /p PHONE_IP请输入IP地址例如 192.168.1.100: if %PHONE_IP% ( echo 未输入IP地址脚本退出。 pause exit /b 1 ) echo 正在尝试通过网络连接 %PHONE_IP%:5555 ... adb connect %PHONE_IP%:5555 echo 连接完成当前设备列表 adb devices -l pause这个脚本完成了从杀死旧服务、重启、通过 USB 切换模式到最终发起网络连接的全过程并将关键步骤和状态反馈出来非常适合在固定开发环境中使用。5.3 连接稳定性维护即使连接成功也可能在使用中意外断开。可以设置一个简单的监控循环在检测到设备离线时自动重连。但更务实的做法是理解其不稳定的原因Wi-Fi 休眠、路由器 QoS 策略、手机系统清理后台等。因此对于需要长时间稳定调试的任务USB 连接仍然是首选。无线调试更适合短期的、需要移动性的调试场景。解决“adb cannot connect ... 10061”的过程本质上是对 Android 调试体系、网络基础和操作系统交互的一次深入实践。它没有一成不变的银弹但通过结构化排查——从验证基础状态、检查网络链路、确认服务端口到调整系统设置——绝大多数问题都可以被定位和解决。最深刻的体会是耐心和顺序往往比盲目尝试更重要。每次成功连接背后都是一次对细节的掌控。