无线调试开不了：Shizuku 前置条件检查
无线调试是什么
Android 11 引入的功能——让应用无需数据线就能通过 adb 获得更高级的系统权限。Operit 调试档配合 Shizuku 需要无线调试通道。
前提条件
在开始排查之前，先确认所有前提都满足：
- [ ] Android 11 及以上（无线调试是 Android 11 引入的）
- [ ] 开发者模式已开启（设置 → 关于手机 → 连续点击版本号 7 次）
- [ ] 手机和电脑 / Shizuku 在同一 WiFi
- [ ] 没有其他 adb 连接占用
场景一：无线调试开关是灰的 / 找不到
可能原因
- 开发者模式没开（最常见）
- Android 版本低于 11（不支持）
- 厂商定制 ROM 隐藏了这个选项（部分华为 / 小米老机型）
解决
- 检查开发者模式：设置 → 关于手机 → 连续点击版本号 7 次 → 会提示「已进入开发者模式」
- 强制开无线调试：开发者模式里找「无线调试」，确保开关在 ON 位置
- 厂商 ROM 隐藏了：部分国产 ROM 把无线调试选项藏得很深或直接移除。这种情况：
- 改用 USB 数据线连接（Operit 调试档支持 USB 方式授权 Shizuku）
- 或考虑 Root 手机（风险更高但更彻底）
场景二：无线调试开了但配对失败
配对步骤回顾
- 开发者选项 → 无线调试 → 打开开关
- 点击「无线调试」进入配对页面
- 点击「使用配对码配对设备」
- 记下配对码 + IP:端口
- 在 Shizuku 或电脑上用
adb pair完成配对
配对失败的常见原因
| 原因 | 解决 |
|---|---|
| 配对码过期 | 配对码有时效（约 5 分钟），过期后重新获取 |
| 不同 WiFi | 确认手机和电脑/Shizuku 在同一 WiFi |
| 防火墙阻断 | 部分路由器开启了客户端隔离——关闭后重试 |
| IP 地址变化 | 手机换 IP 后之前的配对失效，重新配对 |
| adb 版本过旧 | 电脑上的 adb 版本要 32.0+（adb version 查看） |
场景三：配对成功但 Shizuku 连接不上
检查清单
- [ ] Shizuku 显示「已连接」（不是「配对成功」）
- [ ] 无线调试开关保持打开（配对成功后也不能关）
- [ ] 手机没换 WiFi / IP
- [ ] Operit 调试档已授权 Shizuku
Shizuku 手动 adb 连接（电脑上）
如果自动连接不行，可以手动 adb：
# 配对（已配对过跳过这步）
adb pair <手机IP>:<配对端口>
# 连接
adb connect <手机IP>:<调试端口>连接成功后 Shizuku 会自动接管。
USB 数据线方案（最稳）
如果无线调试一直搞不定，数据线是最可靠的替代：
- 手机插 USB → 打开 USB 调试
- USB 连接模式选「文件传输（MTP）」
- 电脑上
adb devices确认设备在列表里 - Shizuku 里选 USB 方式授权
无线调试时效
无线调试的配对状态不是永久的：
- 部分机型约 7 天后过期
- 重启 WiFi / 换 IP 后失效
- 手机重启后可能需要重新配对
建议把 Shizuku 配对当作需要定期维护的事项——约每周检查一次状态，过期了就重新配。