无线调试配对失败 - 配对码输了没反应怎么办

配对流程卡在哪一步

先定位卡点：

对应不同阶段的排查方向。

阶段一：无线调试打不开

可能原因一：Android 版本不够

无线调试（含配对码模式）需要 Android 11（API 30）及以上。Android 10 及以下只能走 USB adb 方式。

# 查 Android 版本（电脑端 adb）
adb shell getprop ro.build.version.release
# 或 Runner 里直接跑
getprop ro.build.version.release

可能原因二：开发者选项里根本找不到无线调试

部分定制系统把无线调试藏得很深，或者改名了：

• MIUI：开发者选项 → 搜索「无线调试」
• ColorOS：开发者选项 → 网络设置 → 无线调试
• 鸿蒙：开发者选项 → 调试 → 无线调试

可能原因三：系统安全策略拦截

MIUI 的安全扫描、ColorOS 的权限监控、EMUI 的支付保护等都可能阻止无线调试开关保持打开。见 02-setup-basics/02-system-specific-settings.md 做针对性配置。

阶段二：配对码不出现

无线调试开关已打开，但点「使用配对码配对设备」后屏幕不显示配对码：

可能原因：通知样式不对

某些系统（如 MIUI）默认通知样式会把配对码折叠进通知中心，不在锁屏/下拉通知栏里明确显示。解决：

1. 进入设置 → 通知与控制中心 → 通知显示设置
2. 选择「原生样式」或「经典样式」（不要 MIUI 特有的卡片样式）

阶段三：配对码输入后没反应

Shizuku 主应用里输入配对码后点确定，界面没有任何变化。

可能原因一：IP 地址或端口变化了

配对码是绑定 IP 和端口的。Wi-Fi 下手机 IP 可能会变：

1. 在无线调试设置页重新确认当前 IP 和端口
2. Shizuku 主应用配对时应该自动读取最新地址
3. 如果输入的配对码对不上当前 IP:Port，配对会静默失败

可能原因二：系统弹窗被拦截

配对过程中系统会弹出"允许配对请求"的确认弹窗。如果 Shizuku 的通知被系统限制（比如 MIUI 的"禁止通知"），这个弹窗不会出现：

1. 设置 → 应用管理 → Shizuku → 权限
2. 允许「通知」权限

可能原因三：配对码过期

配对码有较短的有效期（约 60 秒）。过了之后无线调试页面会刷新出新的配对码——Shizuku 旧码输进去不会成功。

解决方案：

1. 回到无线调试设置页
2. 确认当前最新的配对码
3. 快速回到 Shizuku 主应用输入

阶段四：启动失败

配对成功但 Shizuku 主应用点「启动」后显示启动失败或错误码。

错误码 1001：服务端口被占用

重启手机或清理端口占用进程。

错误码 1002：无法连接无线调试

可能 Wi-Fi 断了、或无线调试被系统自动关闭。回到设置重新开。

错误码 1003：shell 执行失败

Shizuku 启动命令（sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh）执行失败。常见原因：

• 脚本文件不存在（Shizuku 主应用没正确安装）→ 重装 Shizuku 主应用
• SELinux 拒绝 → 在 root 权限下执行 setenforce 0 暂时放宽测试

通用排查步骤

1. 手机重启——很多系统级配对问题重启后自动恢复
2. 重新配对——清空无线调试配对记录 → 从打开无线调试开始重新走流程
3. 换网络——某些公司/学校 Wi-Fi 限制 P2P 通信，换手机热点试
4. USB adb 兜底——无线调试实在搞不定，用 USB 线连电脑跑 adb 启动命令