嵌入式 Linux 与 RTOS / 系统课时
定位早期启动卡点
定位早期启动卡点
早期启动失败最难的地方不是“没有日志”,而是不知道最后一条日志属于启动链的哪一段。本篇用串口末尾信息给故障分层,再借助 earlycon、日志级别和启动参数替换,把范围从整条启动链缩到一个可验证的阶段。
学习目标
- 根据串口最后一条有效日志判断故障位于 Bootloader、内核早期启动、驱动探测还是根文件系统阶段
- 使用
earlycon、loglevel与ignore_loglevel提前暴露内核日志 - 通过临时替换
root=、init=等启动参数验证根文件系统与用户空间边界
先用最后一条日志定阶段
不要一上来就改设备树或重新裁剪内核。先保存完整串口输出,找到最后一条稳定重复出现的有效日志,再判断它前后应该发生什么。
常见边界可以这样读:
| 最后可见位置 | 更可能的故障范围 | 下一步 |
|---|---|---|
还在 U-Boot,未出现 Starting kernel ... |
内核、DTB、地址或加载命令 | 检查镜像地址、大小、启动命令与 DTB |
已出现 Starting kernel ...,随后完全静默 |
解压、早期控制台、架构初始化 | 先启用 earlycon 和最高日志级别 |
| 已有内核时间戳日志,卡在某个设备初始化附近 | 设备树、时钟、电源域、驱动 probe | 根据最后一个驱动继续追踪 |
出现 VFS: Unable to mount root fs |
root=、存储驱动、文件系统驱动或根分区 |
检查根设备和相关驱动是否 built-in |
| 已挂载根文件系统但启动 init 失败 | init=、动态链接库或用户空间 |
临时改为最小 init 验证 |

这张图把笼统的“启动卡死”拆成多个可验证边界。只要确认代码已经越过某个阶段,就不要再把主要精力放回更早的位置。
让内核尽可能早地说话
如果串口能看到 Starting kernel ...,但之后没有任何内核输出,优先怀疑控制台还没初始化,而不是立即断定内核已经死机。可以在 U-Boot 中临时追加调试参数,不先修改永久环境。
下面命令假设原来的 bootargs 已包含正常启动参数。如果平台不能从设备树自动推导 early console,还需要把裸 earlycon 换成 SoC 对应的 earlycon 驱动和 MMIO 参数。
printenv bootargs
setenv bootargs "${bootargs} earlycon loglevel=8 ignore_loglevel"
printenv bootargs
boot预期输出
bootargs=<原启动参数> earlycon loglevel=8 ignore_loglevel
<启动后比原先更早出现的内核日志>实际串口内容会随 SoC、内核版本和控制台驱动变化。这里验证的不是某一条固定日志,而是原来的静默区是否被提前打破。如果仍只看到 Starting kernel ...,应继续检查镜像格式、加载地址、入口地址以及 DTB 是否匹配。
用参数替换验证根文件系统
当日志已经推进到块设备或 VFS,排查重点就从“内核有没有运行”切换为“内核能不能找到并挂载正确的根文件系统”。
优先核对三件事:root= 指向的设备是否真实存在;存储控制器和根文件系统驱动是否直接编进内核;设备枚举较慢时是否需要 rootwait。根文件系统依赖的驱动不能只做成尚未可访问的 .ko 模块,否则会形成“为了读取模块必须先挂载根文件系统”的循环依赖。
如果怀疑根文件系统已经挂载,而正常 init 进程存在问题,可以临时把 init= 指向板上确定存在的最小入口,例如 /bin/sh。若最小 shell 能运行,说明内核、根文件系统和基本挂载链路已经越过,故障应转向用户空间初始化。
卡在驱动 probe 时怎么缩小
内核已经持续打印日志,却总停在同一个驱动附近时,不要只盯着驱动源码。很多“probe 卡死”实际来自设备树资源不完整,例如时钟未打开、复位线没有释放、电源域未就绪,或中断号、寄存器地址错误。
定位时保持单变量:先记录最后一个成功初始化的设备和第一个未完成的设备;再核对可疑节点的 status、compatible、时钟、复位、电源和中断资源;必要时临时禁用该节点,观察启动是否越过原卡点。一次只改一个条件,才能把现象变化与具体修改建立因果关系。
形成可复现的最小证据
每次调整都保留三样东西:完整串口日志、实际 bootargs、本次唯一变更。不要同时修改设备树、内核配置和根文件系统,否则即使机器恢复启动,也无法确定真正生效的是哪项修复。
最终应能明确回答三个问题:启动已经越过哪个边界、下一阶段为什么失败、哪一个最小变更让现象发生了可重复的变化。做到这一点,早期启动故障才算真正被定位,而不是碰巧绕过。