单片机与物联网 / 系统课时
系统化排查流程
系统化排查流程
本课建立一套可重复的 STM32 故障排查顺序:先确认供电和时钟等基础条件,再检查引脚、配置、通信、代码与时序,并用可观察证据逐层缩小范围,避免无目的地改代码。
学习目标
- 按固定顺序完成从硬件到软件的逐层排查
- 为每一步设计可测量、可复现的验证证据
- 使用最小诊断程序区分硬件、配置与业务代码问题
先记录现象和边界
开始修改工程前,先把“发生了什么”写清楚。至少记录故障是否稳定复现、上电后何时出现、哪些功能正常、最近改动了什么,以及复位后是否恢复。现象越具体,后续判断越少依赖猜测。
不要把“串口坏了”当作结论,应改写为“USART1 无输出,但 LED 仍按 500 ms 周期闪烁”。后者已经证明主循环、系统时钟和部分 GPIO 正常,排查范围会立即缩小。
按从底层到上层的顺序检查

固定顺序的价值在于:上层功能依赖下层条件。供电不稳时继续检查协议代码,或时钟未启动时反复修改波特率,都只会制造新的变量。
| 层级 | 关键检查 | 可接受证据 |
|---|---|---|
| 供电 | 测量 VDD、VDDA、GND 和纹波 | 电压位于器件允许范围且上电稳定 |
| 时钟 | 检查时钟源、PLL 和 SystemCoreClock | 调试器可见配置正确,延时周期符合预期 |
| 引脚 | 核对封装、复用、上下拉和电气方向 | 实际引脚电平与代码动作一致 |
| 配置 | 对照 CubeMX、初始化代码和中断优先级 | 外设句柄状态正常,无初始化错误 |
| 通信 | 检查连线、共地、电平、波特率与帧格式 | 逻辑分析仪或示波器看到正确波形 |
| 代码 | 用最小路径替代业务逻辑 | 基础收发或翻转功能独立通过 |
| 时序 | 检查超时、竞争、阻塞和中断执行时间 | 临界路径满足周期与响应要求 |
用最小诊断程序建立证据
下面是片段示例,依赖 CubeMX 已生成 GPIO、USART1 初始化代码,并定义 LED_GPIO_Port、LED_Pin 和 huart1。把它放入现有工程,在主循环中每 500 ms 调用一次,可同时验证主循环、GPIO 和串口发送路径。
#include "main.h"
#include <stdio.h>
extern UART_HandleTypeDef huart1;
void Diagnostic_RunOnce(void)
{
char message[64];
// LED 翻转用于证明主循环仍在持续运行
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
int length = snprintf(
message,
sizeof(message),
"[DIAG] tick=%lu, led=%u\r\n",
HAL_GetTick(),
HAL_GPIO_ReadPin(LED_GPIO_Port, LED_Pin)
);
// 短超时可避免诊断代码长期阻塞主循环
HAL_UART_Transmit(
&huart1,
(uint8_t *)message,
(uint16_t)length,
100
);
}主循环调用方式如下。
while (1)
{
Diagnostic_RunOnce();
HAL_Delay(500);
}预期结果
[DIAG] tick=<TIME>, led=1
[DIAG] tick=<TIME>, led=0<TIME> 为运行时毫秒计数,实际值会变化。若 LED 正常翻转但串口无输出,应集中检查串口引脚复用、连线、电平和波特率;若两者都不工作,应返回检查供电、复位、时钟和初始化流程。
一次只验证一个假设
每次只改变一个变量,并在修改前写出假设。例如:“USART1 无输出是因为 TX 引脚仍处于普通 GPIO 模式。”随后只修改引脚复用并重新测量。若同时更改时钟、波特率和中断代码,即使故障消失,也无法确认真正根因。
排查时优先使用外部证据:万用表确认电压,示波器确认波形,逻辑分析仪确认协议,调试器确认寄存器和执行位置,日志确认状态变化。单看源码只能说明程序“打算做什么”,不能证明硬件“实际做了什么”。
修复后完成回归验证
找到根因后,不要只验证故障现象已经消失。还应恢复原业务代码,重复冷启动、热复位、长时间运行和边界输入,并确认修复没有破坏其他外设。最后记录现象、根因、修复项和验证方法,形成可复用的排查案例。