HardFault 怎么定位？不用仿真器也能找到死机位置

前言

写 STM32 程序一定会遇到这种情况：程序跑着跑着就卡死了，或者进入了某个中断出不来了。最常见的结果就是进入HardFault_Handler——一个死循环。

void HardFault_Handler(void) { // CubeMX 生成的默认处理 while (1); }

大部分人的反应是注释掉while(1)加上printf，但这行不通——HardFault 发生了，printf 大概率也发不出去。

这篇文章讲一套可靠的定位方法，不需要仿真器。

一、HardFault 的常见原因

二、方法一：通过堆栈回溯定位（最可靠）

HardFault 发生时，CPU 会把断点处的寄存器压入栈中。只要读出栈里的值，就知道死在哪一行代码了。

2.1 修改 HardFault_Handler

把默认的while(1)改成这样：

// 在 main.c 或 stm32f4xx_it.c 中 ​ // 定义一个结构体来接收硬件压栈的寄存器 typedef struct { uint32_t r0; uint32_t r1; uint32_t r2; uint32_t r3; uint32_t r12; uint32_t lr; // 返回地址 uint32_t pc; // 断点位置（最重要的！） uint32_t psr; // 程序状态寄存器 } hardfault_stack_t; ​ // 全局变量，方便调试器查看 volatile hardfault_stack_t fault_stack; volatile uint32_t fault_lr; volatile uint32_t fault_sp; ​ void HardFault_Handler(void) { // 获取栈指针 fault_sp = __get_MSP(); ​ // MSP 指向的内容就是压栈的 8 个寄存器 // 如果用的是 PSP（进程栈指针），改成 __get_PSP() fault_stack = *(hardfault_stack_t *)fault_sp; ​ // 保存 LR（链接寄存器） fault_lr = __get_LR(); ​ // 到这里程序就卡死了，用调试器看 fault_stack.pc 的值 while (1); }

2.2 查看 PC 值定位代码

下载运行，触发 HardFault 后：

方法 A（CubeIDE 调试器）：

1. 把程序用 Debug 模式下载

2. 程序跑飞进入 HardFault

3. 在Expressions窗口添加fault_stack.pc

4. 记下这个值，比如0x08001234

5. 在命令行执行：

   arm-none-eabi-addr2line -e LED_Test.elf 0x08001234

   或者用 CubeIDE 的Disassembly窗口搜这个地址

方法 B（没有调试器，串口打印）：

在 HardFault 之前，先把 PC 值想办法发出去——但 HardFault 发生了，串口可能已经不能用了。

更实用的方法：把 PC 值写入备份寄存器或保留在 RAM 中，下次复位后读取：

// 定义一个特殊的 RAM 段，复位后不清零 // 或者在备份寄存器中存 volatile uint32_t last_fault_pc __attribute__((section(".noinit"))); // .noinit 段需在链接脚本中定义，启动文件中跳过该段的清零 ​ void HardFault_Handler(void) { fault_sp = __get_MSP(); fault_stack = *(hardfault_stack_t *)fault_sp; last_fault_pc = fault_stack.pc; // 存下来 while (1); } ​ // 在 main 开头读 int main(void) { HAL_Init(); // ... if (last_fault_pc != 0) { printf("Previous HardFault at: 0x%08lX\r\n", last_fault_pc); last_fault_pc = 0; // 清掉 } // ... }

2.3 解读 PC 值

拿到 PC 值后，怎么知道是哪行代码？

在 CubeIDE 中：

• View → Disassembly → Ctrl+G → 输入 PC 地址 → 看汇编对应到哪条 C 语句

命令行（推荐，最快）：

arm-none-eabi-addr2line -e Debug/LED_Test.elf 0x08001234

输出类似：

E:/workspace/Core/Src/main.c:85

打开 main.c 第 85 行，就是肇事的那行代码。

如果工具链没装 addr2line，也可以把 .elf 拖进STM32CubeProgrammer→ 选Disassembly→ 搜地址。

三、方法二：寄存器分析法（无调试器、无串口）

如果串口和调试器都用不了，还能通过观察 GPIO 电平来缩小范围：

3.1 "心跳灯"定位法

在代码的关键位置加 LED 指示：

int main(void) { HAL_Init(); SystemClock_Config(); ​ // 各个初始化步骤 MX_GPIO_Init(); LED1_ON; // ❶ 如果 LED1 亮 → GPIO 初始化成功 MX_USART1_Init(); LED2_ON; // ❷ 如果 LED2 亮 → USART 初始化成功 MX_SPI1_Init(); LED3_ON; // ❸ 如果 LED3 亮 → SPI 初始化成功 ​ while (1) { // 主循环中翻转 LED4 LED4_TOGGLE(); // LED4 每闪一次说明主循环在正常跑 } }

程序跑飞进入 HardFault 后，看哪颗 LED 亮了：

• 只有 LED1 亮 → USART1_Init 死机了

• LED1、LED2 亮，LED3 没亮 → SPI1_Init 有问题

• LED1~3 都亮，LED4 不闪 → 死在主循环里了

3.2 用 GPIO 输出 PC 值（最硬核的方法）

把 PC 值的高位和低位分别通过两个 GPIO 口输出：

#define DEBUG_PORT_1 GPIOA #define DEBUG_PIN_1 GPIO_PIN_0 // PC 低位（数据线） #define DEBUG_PORT_2 GPIOA #define DEBUG_PIN_2 GPIO_PIN_1 // 时钟信号 — 每输出一位数据翻转一次，供逻辑分析仪双通道同步捕获 ​ void HardFault_Handler(void) { // 读取 PC fault_sp = __get_MSP(); fault_stack = *(hardfault_stack_t *)fault_sp; ​ // 把 PC 值的低 8 位输出到 GPIO for (int i = 0; i < 8; i++) { if (fault_stack.pc & (1 << i)) HAL_GPIO_WritePin(DEBUG_PORT_1, DEBUG_PIN_1, GPIO_PIN_SET); else HAL_GPIO_WritePin(DEBUG_PORT_1, DEBUG_PIN_1, GPIO_PIN_RESET); // 加一个简单的脉冲时序来读 } ​ while (1); }

用示波器或逻辑分析仪抓这两个引脚，就能拼出 PC 值——虽然麻烦，但在某些抓狂的场景确实能救命。

四、方法三：常用工具链方法

4.1 用 CubeIDE 读 LR 寄存器

在调试模式下，程序进入 HardFault 后：

1. 暂停程序（Pause 按钮）

2. 看Registers窗口 → 找到LR（R14）

3. LR 的值指示了是从什么模式进入 HardFault 的：

• 如果是0xFFFFFFF9→ 是在主循环/裸机流程中死的

• 如果是0xFFFFFFF1→ 是在某个中断处理函数中死的

• 如果是0xFFFFFFFD→ 是在 FreeRTOS 某个任务里死的

4.2 分析 Call Stack（调用栈）

CubeIDE 调试器中，当程序卡在 HardFault 时：

1. 暂停

2. 打开Debug透视图 →Call Stack窗口

3. 正常情况下 CubeIDE 已经帮你回溯好了，点上面的调用帧就能看到卡住前的最后一层

4. 如果 Call Stack 显示的地址不对，打开Disassembly窗口搜对应地址

五、最常见的 HardFault 场景实测

场景 1：数组越界

uint8_t arr[10]; for (int i = 0; i <= 50; i++) // 写飞了 arr[i] = i;

结果：arr 之后的变量被覆盖了，硬件异常后进入 HardFault。 PC 定位到arr[i] = i;那行。

场景 2：野指针

void func(void) { uint32_t *p = (uint32_t *)0xDEADBEEF; // 不存在这个地址 *p = 0x12345678; // HardFault 在这里 }

场景 3：栈溢出

void deep_recursion(int n) { char big_buf[1024]; // 每次递归占 1KB 栈 printf("n = %d\n", n); deep_recursion(n + 1); // 递归几十次后就爆了 }

六、预防 HardFault 的小习惯

七、总结

一句话记住：HardFault 不可怕，可怕的是只会while(1)然后束手无策。把 PC 地址读出来，addr2line 一行命令就知道问题在哪。