Android无线调试开启后设备不显示在adb devices列表中？

Question

Android无线调试开启后设备不显示在`adb devices`列表中，是开发者高频遇到的连通性问题。常见原因包括：① 设备与开发机未处于同一Wi-Fi网络（IPv4互通是前提）；② 未正确执行`adb tcpip 5555`切换至TCP模式（需USB连接状态下首次执行）；③ 无线调试开启后未通过“配对码+IP+端口”完成安全配对（Android 11+强制要求，仅启用开关不等于建立ADB连接）；④ 防火墙或路由器AP隔离策略阻断5555/5556端口通信；⑤ `adb connect :`后未出现“connected to…”提示，却误判为成功。特别注意：Android 12+默认禁用非配对ADB over Network，且`adb devices`仅显示已认证、已连接的设备，未配对设备不会列出。排查应优先确认配对状态（设置→开发者选项→无线调试→已配对设备）、验证IP可达性（ping + telnet），并避免混淆“无线调试开关”与“ADB无线连接”两个不同层级的功能。

Answer 1

```html

一、现象层：无线调试已开启，但 adb devices 列表为空

这是最表层的可观测症状——开发者在设备「设置 → 开发者选项 → 无线调试」中滑动开关为开启状态，却在终端执行 adb devices 后未见任何设备（甚至无 * daemon not running; starting daemon... 提示），或仅显示 offline / unauthorized 状态。该现象本身不携带根因信息，需向下穿透至协议栈与安全模型。

二、网络层：IPv4连通性是无线 ADB 的绝对前提

• Android 无线 ADB 仅基于 IPv4 实现（Android 13 仍不支持 IPv6 over ADB）；
• 必须验证开发机与设备处于同一广播域：ping <设备IP> 应返回毫秒级响应；
• 禁用 AP 隔离（常见于企业 Wi-Fi 或公共热点）：路由器后台需关闭 AP Isolation 或 Client Isolation；
• 双频 Wi-Fi（2.4G/5G）易导致设备与 PC 接入不同频段子网，建议强制设备连接 2.4GHz 并固定信道。

三、协议层：ADB TCP 模式切换的隐式依赖链

执行 adb tcpip 5555 并非“一次配置永久生效”，其本质是：

1. 需 USB 连接物理在线（adb devices 显示 device）；
2. 触发 adbd 进程从 USB mode 切换至 TCP listening mode；
3. 重启后失效（Android 12+ 引入 adbd 守护进程持久化策略，但默认仍需重置）；
4. 若跳过此步直接 adb connect IP:5555，将返回 connection refused（端口未监听）。

四、安全层：配对机制（Pairing）是 Android 11+ 的强制认证闸门

Android 版本	是否强制配对	未配对时 adb connect 行为	adb devices 是否列出
≤ Android 10	否	直连成功（若端口开放）	显示 IP:5555
Android 11–12	是（可绕过，但不推荐）	返回 failed to authenticate	完全不出现
≥ Android 13	是（系统级硬限制）	立即拒绝，无日志	永不显示

配对流程必须通过「无线调试 → 配对设备」获取一次性 6 位码，在开发机执行：
adb pair IP:5556 → 输入配对码 → 成功后方可 adb connect IP:5555。

五、系统层：防火墙、SELinux 与 adbd 权限的三重拦截

# 检查设备侧 adbd 是否真正监听 5555/5556
adb shell netstat -tuln | grep ':555[56]'

# 检查 SELinux 策略（Android 8+ 默认 enforcing）
adb shell getenforce  # 应为 Permissive 或 adbd 允许 adb_port

# 开发机防火墙放行（Linux/macOS）
sudo ufw allow 5555 && sudo ufw allow 5556

六、诊断流：标准化排查路径（Mermaid 流程图）

graph TD
  A[adb devices 为空？] --> B{设备与PC同Wi-Fi？}
  B -- 否 --> C[切换至同一IPv4子网]
  B -- 是 --> D[ping 设备IP？]
  D -- 失败 --> E[检查AP隔离/路由器ACL]
  D -- 成功 --> F[telnet 设备IP 5555？]
  F -- 拒绝 --> G[adb tcpip 5555 是否执行？]
  F -- 成功 --> H[无线调试→已配对设备列表有该设备？]
  H -- 否 --> I[adb pair IP:5556 + 配对码]
  H -- 是 --> J[adb connect IP:5555]
  J --> K{返回 connected to...？}
  K -- 否 --> L[检查SELinux/adbd状态]
  K -- 是 --> M[adb devices 应显示]

七、进阶陷阱：开发者常混淆的两个独立功能栈

• 「无线调试开关」：仅启动 adbd 的 TCP 监听服务（含配对端口 5556），不建立任何 ADB 会话；
• 「ADB 无线连接」：需完成配对 + connect 两阶段握手，生成加密 session key 并注册到 adb server 设备列表；
• 错误认知：“开了开关就等于能 adb” —— 实际上开关只是打开「门」，配对是「验身份」，connect 是「进门握手」；
• Android 12+ 在设置中隐藏了旧版「ADB over network」开关，仅保留「无线调试」统一入口，加剧概念混淆。

八、验证清单：5 分钟闭环自检表

检查项	命令/路径	预期结果
设备IP是否获取正确	设置 → 关于手机 → 状态 → IP地址	IPv4，非 169.254.x.x 或 127.0.0.1
配对设备列表是否包含当前设备	设置 → 开发者选项 → 无线调试 → 已配对设备	存在且状态为「已连接」
开发机能否访问配对端口	telnet IP 5556	Connected to ...
adb server 是否重启过	adb kill-server && adb start-server	避免旧连接缓存干扰

九、长效方案：自动化脚本规避重复操作

#!/bin/bash
# android-wifi-adb-setup.sh（需 adb 34.0.5+）
DEVICE_IP="$1"
if [ -z "$DEVICE_IP" ]; then
  echo "Usage: $0 <device_ip>" >&2; exit 1
fi
echo "[1/4] Checking ping..."
ping -c 1 -W 2 $DEVICE_IP >/dev/null || { echo "❌ Ping failed"; exit 1; }
echo "[2/4] Pairing via port 5556..."
adb pair $DEVICE_IP:5556 2>&1 | grep -q "Successfully paired" || { echo "❌ Pairing failed"; exit 1; }
echo "[3/4] Connecting on 5555..."
adb connect $DEVICE_IP:5555 2>&1 | grep -q "connected to" || { echo "❌ Connect failed"; exit 1; }
echo "[4/4] Final verification..."
adb devices | grep -q "$DEVICE_IP:5555" && echo "✅ Ready: $(adb devices)"

十、延伸思考：为什么 Android 不回归「免配对」模式？

根本原因在于攻击面收敛：传统 ADB over WiFi 无认证即允许 shell 访问，曾被用于大规模 IoT 设备劫持（如 Mirai 变种）。Google 通过配对码绑定设备指纹（adbd 的 RSA 公钥哈希）、限制单次有效时长（配对码 3 分钟过期）、分离控制端口（5556）与数据端口（5555）实现纵深防御。这也解释了为何 Android 12+ 彻底移除 setprop service.adb.tcp.port 5555 等绕过手段——安全模型已从「通道开放」升级为「设备信任链」。

```