Shizuku 连接失败的常见原因和解决方案

Shizuku 是 zFont3 最关键也最容易卡住的环节。按下面顺序排查，不要跳。

问题一：配对码收不到

1. 通知权限：Shizuku App → 允许所有通知权限（尤其是配对通知）
2. 无线调试开关：开发者选项里确认「无线调试」已打开（不是「USB 调试」）
3. Wi-Fi 连接：手机要连着 Wi-Fi（哪怕是另一台手机开的热点也行）
4. 手动输入：下拉通知栏找 Shizuku 通知 → 点「输入配对码」手动进去

问题二：配对成功但 Start 失败

经典报错：「Service Start Failed」或一直卡在 Starting。

最常见原因（90% 的情况）：Shizuku 对应用户的授权没有正确写入。

解决：

1. 打开 Shizuku → 应用管理（Application management）
2. 找到 zFont3 → 把旁边的开关关掉
3. 重新打开 zFont3 → Settings → File Handler → Shizuku → 重新授权

如果还不行，去 Shizuku 官方仓库找 thedjchi/Shizuku 这个 fork 版本试——某些 ROM 上原版 Shizuku 有 bug。

问题三：每次重启后 Shizuku 要手动重连

Shizuku 的 Shell 服务会被系统电池优化杀掉。解决办法：

1. Shizuku App → 允许自启动（如果你的 ROM 有这个选项）
2. 电池优化里把 Shizuku 设为「不受限制」
3. Shizuku App → 前台服务常驻（部分版本支持）

问题四：Shizuku 在 Android 14/15 上连不上

某些厂商 ROM（尤其是小米 HyperOS 早期版本、vivo OriginOS 4）对无线调试做了额外限制。试以下操作：

1. 关掉无线调试再重新打开
2. 切换 Wi-Fi（换个网络或用手机热点）
3. 手机飞行模式再切回来
4. 实在不行换 ADB 数据线方式（05-文件接入方式/03-shizuku-adb-usb.md）

问题五：配对成功后 zFont3 里说「未授权」

配对和授权是两步——Shizuku 跑起来了不代表 zFont3 拿到了权限：

1. zFont3 → Settings → File Handler → Shizuku
2. Shizuku 会弹出授权请求 → 点「允许」
3. 回到 zFont3，File Handler 状态变成绿色才算完成

终极方案

如果 Shizuku 一直连不上，先换 SAF 试试（Android 11-12 限定）；SAF 也不行就只能 Root 了。但绝大多数 Shizuku 问题都能通过重配对 + 重新授权解决。