Shizuku 连不上:五类常见症状与解决
症状一:Shizuku App 里显示 "not running"
最基础的问题——Shizuku 根本没启动成功。
排查顺序:
- 确认电脑或手机上执行了 start.sh 脚本(见 Shizuku 部署与授权)
- 电脑端执行
adb devices,手机有没有在列表里?没有的话是 USB 驱动问题(Windows 常见) - 手机上开发者选项 → 撤销 USB 调试授权 → 重新插线 → 重新点"允许调试"
- 换一根确定支持数据传输的 USB 线(很多线只有充电功能)
- 换电脑 USB 口(不要插前面板的前置口)
症状二:USB 调试开启但 Shizuku 连不上
很多厂商系统有额外的开关:
| 厂商 | 需要额外开的 |
|---|---|
| MIUI | 开发者选项 → USB 调试(安全设置)(独立于 USB 调试的另一个开关) |
| EMUI/HarmonyOS | 开发者选项 → 仅充电模式下允许 ADB 调试 |
| ColorOS/OxygenOS | 开发者选项 → USB 安装 + USB 调试(安全设置) |
| OneUI | 通常正常,不需要额外开关 |
| 原生 AOSP | 不需要额外开关 |
MIUI 用户最容易踩这个坑——USB 调试和 USB 调试(安全设置)是两个独立开关,只开前者 Shizuku 的 ADB 授权不通过。
症状三:无线调试连不上(Android 11+)
无线调试依赖稳定的 Wi-Fi 环境:
- 配对和连接是两步,端口号不一样。配对码用的端口和调试用的端口是两个不同数字,别搞混
- 手机和电脑必须在同一个局域网(同一个路由器)
- 路由器如果开了 AP 隔离/客户端隔离,关掉——这个功能会阻止局域网内设备互相访问
- 某些公共 Wi-Fi(比如咖啡店、酒店)的网关策略会阻止设备间通信,换家用 Wi-Fi
- 电脑防火墙如果阻止 adb.exe 出站,关掉试试
完整流程复习:
# 第一步:配对(端口配对用的)
adb pair <ip>:<pair_port> # 输入配对码
# 第二步:连接(连接调试端口)
adb connect <ip>:<debug_port>
# 第三步:启动 Shizuku
adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh
症状四:Shizuku 显示 running 但 LSPatch Manager 说 "Shizuku unavailable"
这种情况 Shizuku 本身是好的,但 LSPatch 没有拿到授权。
- 打开 Shizuku App → 已授权应用
- 找到 LSPatch Manager(或 opatch/onpatch),打开开关
- 如果列表里没有 LSPatch Manager:
- 升级 LSPatch Manager 到最新版
- 确认你装的 Manager 版本支持 Shizuku 集成(某些老版本或二次魔改版可能没有)
- 重启手机再试
授权是动态的——Shizuku 服务重启或手机重启后,授权可能被重置。每次 Shizuku 服务重新启动后都要去已授权应用里确认一次。
症状五:Shizuku 自动断开(每次只撑 10 分钟)
这是 ADB 的默认行为——ADB 授权有过期机制,超时后自动断开。
三种解法:
解法 1:每次连一下最省事。手机上开个快捷方式,需要用 Manager 快速安装时手动重新执行 start.sh。无线调试重连很快。
解法 2:Root 方式启动 Shizuku如果手机有 Root(Magisk/KernelSU),在 Shizuku App 里选「通过 Root 启动」。Root 模式下 Shizuku 会作为持久后台服务,永不超时永不断开。
解法 3:用 Shizuku Starter 之类的辅助工具酷安搜自动启动 Shizuku 的工具,原理是在你每次解锁手机时自动执行一次 start.sh。适合无线调试场景。
快速自检脚本
电脑上 adb 环境就绪的情况下,一条命令完成 Shizuku 启动:
adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh
执行完后 Shizuku App 里应该显示 "running"。然后去已授权应用里给 LSPatch Manager 开授权,就搞定了。