排错手册

刷机问题排查指南

这页只做无破坏性排查。先记下完整机型、当前模式和报错，再查对应机型的官方或维护者文档。

开始排查前

先记录这些信息

  • 完整机型、设备代号、系统或 ROM 构建号
  • 当前能进入系统、Recovery、Fastboot，还是只能看到某个 USB 端口
  • 屏幕上的完整报错、故障出现前最后一次操作、用过的文件名和下载来源
  • ADB 可用时保存 adb devices -l 和 adb bugreport；Fastboot 可用时保存 fastboot getvar product 和 fastboot getvar current-slot
先停下来：不要用通用教程清数据、解锁、关闭 AVB、写入分区或拆机短接。分享日志前遮住序列号、IMEI、账号和个人路径。

无法开机或只有 9008 端口

症状

按电源键无任何反应，屏幕全黑，连接电脑无识别或仅显示 QDLoader 9008 端口。
可能范围
  • 电量、线材、USB 端口或屏幕显示异常
  • 安装包与设备代号不匹配，或安装中断
  • 启动链或硬件故障；仅凭黑屏无法远程区分
先做这些
  1. 用可靠充电器和线材充电至少 30 分钟，再按厂商手册执行该机型的强制重启
  2. 换一根确认支持数据传输的线，并直接连接电脑 USB 端口
  3. 记录设备管理器、system_profiler SPUSBDataType 或 lsusb 显示的端口名称和硬件 ID
  4. 如果能进 Fastboot，只采集 product、current-slot 等只读信息，不写入镜像
  5. 出现 9008 端口时，带着完整机型、硬件 ID、固件版本和最后一次操作联系官方售后
不要继续尝试：不拆机短接，不使用来源不明的 Firehose、分区表、QFIL 配置或账号授权服务。厂商没有公开该机型恢复流程时，应交给官方售后或合格维修人员。

Bootloop（卡开机动画）

症状

设备开机后卡在品牌 Logo 或开机动画处无限循环，无法进入桌面。
可能范围
  • ROM、固件基线、设备代号或当前槽位不匹配
  • 最近安装的 Root 模块、内核或系统文件修改不兼容
  • OTA 安装未完成，或启动时发生硬件异常
先做这些
  1. 记录设备代号、ROM 完整文件名、校验值、当前槽位和最后一次正常启动的构建号
  2. 列出故障前安装或修改的模块、内核、系统文件和 OTA
  3. ADB 可用时保存 adb logcat -b all -d 和 adb bugreport
  4. 拍下 Recovery 或 Fastboot 的完整报错，不要只记录最后一行
  5. 按该机型厂商或 ROM 维护者的恢复文档核对固件、槽位和回退要求
保留数据：不要把清缓存、双清或格式化 data 当成通用测试。即使怀疑 Magisk 模块，也应按当前 Magisk 版本和该机型的恢复文档停用，避免直接删除未知目录。

信号问题（无基带 / 无 IMEI）

症状

状态栏显示「无信号」，设置中基带版本显示「未知」，IMEI 显示为 0 或 null。
可能范围
  • SIM 卡、运营商网络或系统网络设置异常
  • 固件与当前系统不匹配，或基带信息无法读取
  • 设备标识或射频相关数据受损，需要厂商诊断
先做这些
  1. 在不公开设备标识的前提下，记录基带版本、系统构建号和 IMEI 是否可读
  2. 关机后重新安装 SIM 卡，并用已知正常的 SIM 卡交叉测试
  3. 记录故障前是否更换过 ROM、固件或区域版本
  4. 系统可用时生成 bugreport，分享前遮住 IMEI、序列号和账号信息
  5. 带着这些信息联系厂商售后或该机型 ROM 维护者
不要写入：不要从其他设备复制 modem、radio、QCN 或 EFS，也不要按通用教程改 IMEI。此类写入既可能扩大损坏，也涉及隐私和合规问题。

无限重启

症状

手机开机几秒到几分钟后自动重启，有时能进入桌面但很快又重启，反复循环。
可能范围
  • 电池电量极低导致电压不稳定，系统保护性重启
  • 内核或内核模块冲突（如刷入了非对应 Android 版本的内核）
  • 最近的系统更新、Root 模块或应用导致崩溃
  • 硬件问题：电池老化、充电 IC 损坏、主板虚焊
先做这些
  1. 记录重启频率、剩余电量、是否插电、是否发热，以及故障前最后一次更新
  2. 系统能短暂进入时，立即备份普通文件并生成 adb bugreport
  3. 按厂商说明尝试安全模式，观察停用第三方应用后是否仍重启
  4. 查看设置中的电池状态和系统更新记录，不在 Fastboot 中清除或写入分区
  5. 伴随电池鼓包、异味、异常高温或进水时立即停止充电并送修
如何判断：插电状态、温度和日志只能帮助缩小范围，不能单独确认电池、CPU 或电源 IC 故障。硬件结论需要检测。

OTA 更新失败

症状

系统下载完 OTA 更新包后，重启进入 Recovery 并在安装过程中报错，或卡在安装界面然后重启回原系统。
可能范围
  • 修改了 system 分区（如删除了系统应用、替换了字体等）
  • 安装了 Magisk 模块，修改了 boot 分区或 systemless 文件
  • 使用了第三方 Recovery（TWRP / OrangeFox），OTA 安装脚本不兼容
  • vendor 分区与 system 分区版本不匹配
先做这些
  1. 记录更新前构建号、目标构建号、完整错误代码和失败百分比
  2. 列出 Root、第三方 Recovery、系统文件和启动镜像修改情况
  3. 确认 OTA 来自系统更新或厂商支持页面，并且适用于当前地区和构建
  4. 系统仍能启动时先备份数据，再按厂商针对该机型的更新恢复说明处理
  5. 厂商要求使用完整恢复包时，必须使用其页面给出的文件、校验值和步骤
不要混用文件：不要自行刷回通用 system、boot 或 recovery 镜像，也不要从相近机型复制。分区结构和签名必须与完整机型、地区及构建一致。