FolkPatch常见问题排错清单:Root失败与模块加载的12个疑难解答
FolkPatch常见问题排错清单:Root失败与模块加载的12个疑难解答
FolkPatch 是基于 KernelPatch 的 Android Root 管理工具,通过修补并刷写 boot 分区获得内核级 Root,同时提供 APM 系统模块、KPM 内核模块、Lua 插件与 Shizuku 服务管理。本文整理了 12 个最常见的 FolkPatch Root 失败与模块加载疑难问题,每个问题都附带可直接执行的排查步骤,帮你快速定位故障原因。
小贴士:应用内已内置完整的中文常见问题解答,路径见 app/src/main/assets/faq/zh-rCN.json,界面实现位于 FaqScreen.kt。遇到本文未覆盖的情况,可先在设置中打开 FAQ 页面对照查看。
一、刷写与开机类:刷完变砖先做这一步
1. 修补刷入后无法开机:Fastboot 恢复原始 boot.img
刷完 FolkPatch 补丁后黑屏、卡 Logo,通常由四类原因造成:boot 镜像与系统版本不匹配、KernelPatch 与内核不兼容、刷错分区、模块破坏启动。
排查顺序:
- 不要反复盲目刷写,先确认手里有当前系统版本对应的原始 boot.img 备份;
- 设备若能进 Fastboot 或 Recovery,立即刷回原始 boot.img 恢复出厂状态;
- 若故障出现在装模块之后,优先回退最近动过的 APM 或 KPM 模块。
⚠️ 安装 FolkPatch 前必须先解锁 Bootloader 并备份原始 boot.img,这是所有 Root 方案的安全底线。安装流程可参考 Install.kt 对应的应用内引导页面。
2. 修补对象搞错:只修补 boot.img,别用 init_boot
FolkPatch 当前只修补 boot 镜像。请勿把 init_boot.img、vendor_boot.img 等其他启动镜像当作修补对象,否则大概率开不了机。
如果你的设备启动结构比较特殊,先在 Recovery/Fastboot 中确认设备实际使用的 boot 分区,再取对应的原始镜像进行修补。
3. 内核版本在范围内却提示"不支持"
FolkPatch 支持 Linux Kernel 3.18 至 6.18 的 ARM64 设备,但版本号达标不等于兼容。厂商深度定制内核、第三方内核可能有特殊的结构、符号或配置,即使版本号在范围内也可能修补失败。
遇到此类提示:先确认 boot.img 确实来自当前系统版本,再向社区反馈时附上内核版本与设备型号,不要只看版本号下结论。
二、认证与更新类:版本对不上就动这里
4. 重装 FolkPatch 后认证失败
FolkPatch 4.3 起改用 APK 签名验证认证管理器,不再使用旧版 SuperKey 机制。卸载重装管理器后,KernelPatch 可能仍保存着旧管理器的状态,导致暂时认证失败。
处理办法:
- 先重启设备,让 KernelPatch 重新检测当前管理器;
- 仍失败则核对 KernelPatch 与 FolkPatch 管理器版本是否匹配。
按旧教程配置 SuperKey 的朋友注意了:当前版本无需再生成或配置 SuperKey,那是 4.3 以前的认证方式。
5. 旧版 KernelPatch 无法认证当前 FolkPatch
管理器认证依赖 KernelPatch 的签名验证能力,较早版本不含该能力,无法与当前版本完成认证。若出现此情况,请升级 KernelPatch 至满足当前认证机制要求的版本,而不是回退管理器。
6. 升级 KernelPatch 后版本没变化
重启后仍显示旧版本,最常见的原因是:防变砖类 KPM 拦截了对 boot 等关键分区的写操作,导致更新实际未生效。
步骤:
- 进入 KPM 管理页面(对应 KPM.kt 实现的列表),暂时禁用可能影响分区写入的防变砖类模块;
- 确认 boot 镜像与当前系统版本匹配;
- 重新升级并重启,再恢复刚才禁用的模块。
7. Android 系统更新后 Root 消失了
A/B 无缝更新会把新系统写入另一个 Slot,切换过去后该 Slot 的 boot 镜像未经 FolkPatch 修补,Root 自然暂时失效。
两种应对:
- OTA 完成后、重启进新系统之前,若设备支持非活动 Slot 安装,直接把 FolkPatch 装到非活动 Slot;
- 已经进入新系统且 Root 丢失:获取对应系统版本的原始 boot.img,重新修补刷入。
三、Root 授权类:权限给了应用却"看不见"
8. 已授予 Root,应用仍提示没有 Root
先在超级用户页面(界面实现见 SuperUser.kt,批量授权逻辑见 SuperUserViewModel.kt)确认目标应用确实已获授权,然后彻底结束应用进程再重新启动。
若授权状态正常仍检测不到,重点排查:
- 应用使用了其他检测手段:
su路径、SELinux 状态、挂载环境等; - 系统中残留 Magisk 或 KernelSU 等其他 Root 环境,多个 Root 方案共存会互相干扰,建议清理干净。
9. Root 路径显示为 /system/bin/kp 而不是 su
这是保护机制:当系统里存在其他 Root 方案或残留时,FolkPatch 会改用 /system/bin/kp 作为 Root 路径,避免与既有环境冲突。
想恢复传统 /system/bin/su 路径:先彻底卸载其他 Root 方案并清理残留,再重新配置。注意修改路径可能影响部分应用的检测兼容性。
10. Root 授权弹窗不出现
按顺序排查:
- 确认 FolkPatch 自身 Root 状态正常、超级用户页面可正常工作;
- 重启目标应用,检查它是否已被设置为拒绝或永久拒绝 Root 权限;
- 若问题出现在装/更新模块之后,优先禁用最近改动的 KPM 或 APM 做二分排查。
四、模块加载类:装了没效果先分清 APM 与 KPM
11. 安装了模块却没有生效
"安装成功"≠"一定生效",APM(Android 模块)与 KPM(内核模块)运行层级和加载方式完全不同:
| 类型 | 运行层级 | 典型场景 |
|---|---|---|
| APM | Android 系统层 | 修改/扩展系统功能,对应 APM.kt 管理页面 |
| KPM | 内核层 | 扩展内核功能,对应 KPM.kt 管理页面 |
标准排查步骤:
- 确认模块已安装且处于启用状态;
- 按模块自身说明重启设备(部分模块不重启不加载);
- 仍无效则检查模块版本与 Android 版本、内核版本的兼容性,以及是否依赖其他模块。
12. 安装模块后卡开机动画 / 无限重启
出现卡 Logo、自动重启或无法进系统时,第一嫌疑永远是最近安装或更新的模块,KPM 尤其危险——它直接运行在内核层,兼容性问题是直接破坏开机的主要原因。
- 能进系统:立即禁用或卸载最近的模块;
- 进不了系统:按设备恢复条件处理(Fastboot 恢复模式、Recovery 等),必要时刷回原始 boot.img。
📌 安装来源不明的 KPM 前,务必确认来源可信以及与当前内核兼容,这是最省心的避坑原则。
五、反馈前必看:一次说清问题需要哪些信息
遇到本文未覆盖的故障,向社区反馈时尽量提供以下完整信息,能显著加快定位速度:
- 设备厂商与具体型号、Android 版本、Linux Kernel 版本
- FolkPatch 版本、KernelPatch 版本
- 当前 boot.img 是否来自当前系统版本
- 已安装的 APM 与 KPM 清单
- 完整错误信息或日志、问题出现前执行过的操作
最后再强调一次安全前提:修补 boot、安装模块都可能影响系统稳定性,动手前请确认原始 boot.img 已备份、设备可进 Fastboot 或 Recovery。更多功能与模块文档说明可参考 README_CN.md 的完整介绍。
祝顺利 Root,少踩坑!
