问题现象：中断服务程序“消失”了

最近在调试一个STM32F4项目时遇到一个诡异现象：串口接收中断配置正确，NVIC使能无误，但USART1_IRQHandler中的断点始终无法命中。更奇怪的是，用调试器查看中断向量表，发现USART1_IRQHandler的地址指向了HAL库的默认处理函数，而非用户自己编写的函数。

// 用户代码：stm32f4xx_it.c
void USART1_IRQHandler(void)
{
    HAL_UART_IRQHandler(&huart1);  // 断点在此处不命中
    // 用户自定义逻辑...
}

原理剖析：__weak与重定向机制

什么是__weak函数

在ARM Compiler（Keil MDK）或GCC中，__weak是一个链接器属性，表示该函数为弱符号。当链接器发现同时存在弱符号和强符号（同名但无__weak修饰）时，会优先选择强符号，丢弃弱符号。

HAL库大量使用此机制：在stm32f4xx_hal_uart.c中定义了__weak void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)，允许用户在自己的文件中重新实现同名函数来覆盖默认空实现。

中断服务程序的重定向陷阱

关键点在于：启动文件（startup_stm32f4xx.s）中的中断向量表将USART1_IRQHandler定义为弱符号，而HAL库的stm32f4xx_hal_uart.c中同样定义了__weak void USART1_IRQHandler(void)。当用户在自己的stm32f4xx_it.c中实现void USART1_IRQHandler(void)时，理论上应覆盖弱符号。

但若用户实现时遗漏了void关键字或函数签名不匹配（如误写为void USART1_IRQHandler()），编译器会将其视为不同函数，导致链接器仍选择弱符号，中断向量表指向HAL库的默认处理函数（通常为空或仅调用错误回调）。

排查路径：五步定位法

第一步：确认中断向量表指向

在调试器中查看0x08000000 + 0x3C（USART1中断偏移）处的值，或直接查看USART1_IRQHandler符号地址。若指向HAL_UART_IRQHandler的默认弱实现，则重定向失败。

第二步：检查函数签名一致性

对比用户实现与启动文件中的声明：

// 启动文件中的弱声明（汇编）
WEAK USART1_IRQHandler

// 用户实现必须严格匹配
void USART1_IRQHandler(void)  // 必须带void参数
{
    // ...
}

常见错误：void USART1_IRQHandler()（C语言中空参数列表表示任意参数，与void不等价）。

第三步：检查链接脚本与符号表

使用arm-none-eabi-nm或Keil的.map文件查看符号：

arm-none-eabi-nm -n project.elf | grep USART1_IRQHandler

若输出显示W USART1_IRQHandler（W表示弱符号），说明用户实现未被链接。

第四步：确认文件参与编译

检查stm32f4xx_it.c是否被加入工程编译列表，且未被条件编译宏排除。

第五步：验证重定向生效

在用户ISR中设置断点，触发中断后观察是否命中。或通过GPIO翻转+示波器测量。

完整代码示例：正确的中断重定向

// stm32f4xx_it.c
#include "main.h"

extern UART_HandleTypeDef huart1;

// 正确：严格匹配启动文件中的签名
void USART1_IRQHandler(void)
{
    HAL_UART_IRQHandler(&huart1);
}

// 回调函数重定向（HAL库机制）
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
    if (huart->Instance == USART1) {
        // 用户接收完成处理
        HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
    }
}

// main.c 中初始化
UART_HandleTypeDef huart1;

void MX_USART1_UART_Init(void)
{
    huart1.Instance = USART1;
    huart1.Init.BaudRate = 115200;
    huart1.Init.WordLength = UART_WORDLENGTH_8B;
    huart1.Init.StopBits = UART_STOPBITS_1;
    huart1.Init.Parity = UART_PARITY_NONE;
    huart1.Init.Mode = UART_MODE_TX_RX;
    huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
    huart1.Init.OverSampling = UART_OVERSAMPLING_16;
    if (HAL_UART_Init(&huart1) != HAL_OK) {
        Error_Handler();
    }
    // 使能接收中断
    HAL_NVIC_SetPriority(USART1_IRQn, 0, 0);
    HAL_NVIC_EnableIRQ(USART1_IRQn);
}

注意事项与最佳实践

严格匹配签名：中断服务程序必须与启动文件中的声明完全一致，包括void参数列表。
避免重复定义：不要在多个文件中定义同一个ISR，否则链接器可能报错或行为不确定。
使用__weak回调而非ISR：优先通过HAL库的回调机制（如HAL_UART_RxCpltCallback）扩展功能，而非直接重写ISR，减少耦合。
检查启动文件版本：不同STM32系列的启动文件中断名可能略有差异（如USART1_IRQHandler vs USART1_IRQHandler），以实际文件为准。
利用.map文件：定期检查符号表，确认关键函数未被弱符号覆盖。
编译器差异：GCC使用__attribute__((weak))，Keil使用__weak，跨平台时注意宏定义。

通过以上排查路径，可快速定位并解决__weak重定向导致的中断失效问题，确保嵌入式系统的实时响应可靠性。

STM32 HAL库中__weak函数重定向导致中断服务程序失效的排查路径