Skip to content

无限重启(bootloop)

Jump to bottom
zzh20188 edited this page Dec 25, 2025 · 1 revision

无限重启/bootloop

Chinese / 中文

常见无法开机 (Bootloop) 解决方案

  1. OnePlus / Realme / OPPO： 进入系统 Recovery 模式，执行清除数据 (Format Data) 操作后再次重启。

  2. 小米 (Xiaomi)： 少数机型因为启动引导受 AVB 验证限制导致无法启动分区，需要关闭 AVB 验证。

  3. ZRAM 问题： 一些机型或系统在使用带有 ZRAM 补丁的内核时可能会导致无法开机。

    • 方案 A： 刷入 Release 中不带 ZRAM 的内核。
    • 方案 B： 在编译选项中不勾选 [增加更多ZRAM算法] 以编译无 ZRAM 的内核。

  4. 其他原因：

    • KSU 驱动导致的 Bootloop。
    • 构建内核时存在未修复的错误代码，导致镜像损坏。

  5. 安卓防回滚机制 (Anti-Rollback)： 刷入的内核子版本低于官方原厂版本，通常会导致启动失败。

    举例说明： 假设你一直使用 5.10.168 版本且一切正常；某天手机 OEM 推送更新，你的系统内核版本升级到了 5.10.198。 此时，如果你尝试刷回旧的 5.10.168 版本内核，就会触发防回滚机制，导致无法开机。

English

Bootloop Troubleshooting Guide

  1. OnePlus / Realme / OPPO: Boot into system Recovery, perform a Format Data operation, and then reboot.

  2. Xiaomi: Some models fail to boot due to AVB (Android Verified Boot) verification. You may need to disable it. Refer to this guide: Disable AVB.

  3. ZRAM Issues: Certain devices or ROMs may encounter bootloops when using kernels with ZRAM patches.

    • Solution A: Flash a kernel marked as "No-ZRAM" from the Release page.
    • Solution B: If compiling manually, uncheck the [增加更多ZRAM算法] option to compile a kernel without ZRAM extensions.

  4. Other Causes:

    • Bootloops caused by KernelSU driver conflicts.
    • Corrupted kernel images built with unresolved source code errors.

  5. Android Anti-Rollback (ARB) Protection: Boot failure may occur if the kernel version you are flashing is lower (older) than the version currently installed by the official OEM firmware.

    Example: Your device received an OEM update and the system kernel version is now 5.10.198. If you attempt to flash a custom kernel built on an older version (e.g., 5.10.168), the Anti-Rollback mechanism will prevent the device from booting.

end

GKI_KernelSU_SUSFS Project

欢迎来到 GKI_KernelSU_SUSFS 项目的官方文档。 Welcome to the official documentation for the GKI_KernelSU_SUSFS Project.

🇨🇳 中文文档

1. 下载前必读

  • 👉 进入页面：如何选择版本

    重要提醒： 很多新手因为看错了版本导致无法开机。不要看手机设置里的安卓版本，请点击这里查看如何正确匹配内核文件名。

2. 功能列表

  • 👉 进入页面：支持的功能 / Features

    包含组件： 查看本仓库构建的内核集成了哪些功能（如 KernelSU, SUSFS, ZRAM 算法等）以及相关的开发者致谢。

3. 故障排查

  • 👉 进入页面：无限重启 (Bootloop)

    救砖指南： 如果刷入内核后遇到无法开机、卡 Logo 或无限重启的情况，请阅读此页面的解决方案。

4. 问题反馈

  • 👉 进入页面：BUG 反馈须知

    提交 Issue 前必读： 本仓库仅负责自动构建。在反馈问题前，请务必阅读此页面，了解哪些是构建问题，哪些是上游代码问题。

5. 自定义编译

  • 👉 进入页面：Fork 与自定义编译指南

    动手实践： 学习如何 Fork 本仓库并使用 GitHub Actions 自动构建属于自己的内核，支持自定义配置和补丁。

6. 其他

救砖 和 技巧

🇺🇸 English Documentation

1. Must Read: Before You Download

  • 👉 Go to Page: How to Choose

    Critical Step: Many users encounter bootloops because they check the wrong android version. Do not rely on your phone settings. Read this to match the correct kernel filename.

2. Features List

  • 👉 Go to Page: Features

    What's Inside: Check which components (KernelSU, SUSFS, ZRAM algorithms, etc.) are included in these builds and view the credits.

3. Troubleshooting

  • 👉 Go to Page: Bootloop / Stuck on Logo

    Rescue Guide: If your device is stuck in a bootloop or hangs at the logo after flashing, check this page for solutions.

4. Bug Report

  • 👉 Go to Page: Bug Report Policy

    Read Before Posting: This repository is for automated builds only. Please read this to understand the scope of support (Build issues vs. Upstream code issues).

5. Others

Unbrick and Tips

Clone this wiki locally