LSPatch 中文文档 下载 App

Shizuku 连不上:五类常见症状与解决

症状一:Shizuku App 里显示 "not running"

最基础的问题——Shizuku 根本没启动成功。

排查顺序:

  1. 确认电脑或手机上执行了 start.sh 脚本(见 Shizuku 部署与授权)
  2. 电脑端执行 adb devices,手机有没有在列表里?没有的话是 USB 驱动问题(Windows 常见)
  3. 手机上开发者选项 → 撤销 USB 调试授权 → 重新插线 → 重新点"允许调试"
  4. 换一根确定支持数据传输的 USB 线(很多线只有充电功能)
  5. 换电脑 USB 口(不要插前面板的前置口)

症状二:USB 调试开启但 Shizuku 连不上

很多厂商系统有额外的开关:

厂商需要额外开的
MIUI开发者选项 → USB 调试(安全设置)(独立于 USB 调试的另一个开关)
EMUI/HarmonyOS开发者选项 → 仅充电模式下允许 ADB 调试
ColorOS/OxygenOS开发者选项 → USB 安装 + USB 调试(安全设置)
OneUI通常正常,不需要额外开关
原生 AOSP不需要额外开关

MIUI 用户最容易踩这个坑——USB 调试和 USB 调试(安全设置)是两个独立开关,只开前者 Shizuku 的 ADB 授权不通过。

症状三:无线调试连不上(Android 11+)

无线调试依赖稳定的 Wi-Fi 环境:

  1. 配对和连接是两步,端口号不一样。配对码用的端口和调试用的端口是两个不同数字,别搞混
  2. 手机和电脑必须在同一个局域网(同一个路由器)
  3. 路由器如果开了 AP 隔离/客户端隔离,关掉——这个功能会阻止局域网内设备互相访问
  4. 某些公共 Wi-Fi(比如咖啡店、酒店)的网关策略会阻止设备间通信,换家用 Wi-Fi
  5. 电脑防火墙如果阻止 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 没有拿到授权。

  1. 打开 Shizuku App → 已授权应用
  2. 找到 LSPatch Manager(或 opatch/onpatch),打开开关
  3. 如果列表里没有 LSPatch Manager:

授权是动态的——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 开授权,就搞定了。