问题现象与背景

在STM32项目中使用HAL库时，常遇到外设中断（如USART、TIM、EXTI）配置正确但无法进入中断服务函数的情况。调试发现中断标志已置位，但对应的IRQHandler未被调用。这往往与HAL库中__weak函数的重定向机制有关。

典型现象：中断使能后，外设产生中断请求，但程序不跳转至用户编写的回调函数。
根本原因：启动文件中的中断向量指向默认的__weak函数，用户未正确重写该函数，或重写后未链接到向量表。

__weak机制原理解析

__weak是编译器（如ARMCC、GCC）支持的弱符号修饰符，用于定义可被覆盖的函数或变量。在STM32 HAL库中，中断服务函数（如USART1_IRQHandler）在启动文件（startup_stm32fxxx.s）中定义为弱符号，默认实现为空或无限循环。

; 启动文件片段（GCC语法）
.weak USART1_IRQHandler
.thumb_set USART1_IRQHandler, Default_Handler

当用户在其他C文件中定义同名函数且不加__weak时，链接器会优先使用强符号（用户函数），覆盖弱符号。若用户未定义，则链接到Default_Handler（通常为死循环），导致中断“不响应”。

排查路径与步骤

步骤1：确认中断向量表指向

检查启动文件中的中断向量表，确认目标中断的入口地址是否指向用户函数。可通过反汇编或map文件查看。

使用arm-none-eabi-objdump -d生成反汇编，搜索USART1_IRQHandler。
若地址指向Default_Handler，说明用户函数未链接成功。

步骤2：检查用户函数定义

确保用户函数名与启动文件中的符号完全一致（大小写敏感），且未加__weak修饰。

// 正确写法：强符号，覆盖弱符号
void USART1_IRQHandler(void) {
    HAL_UART_IRQHandler(&huart1);
}

常见错误：函数名拼写错误（如USART1_IRQhandler）、误加__weak、定义在未被编译的文件中。

步骤3：验证链接顺序与符号解析

链接器按目标文件顺序解析符号，若用户函数所在文件未被加入编译，或链接脚本未包含该段，则弱符号生效。

检查Makefile/IDE工程是否包含用户源文件。
查看map文件，确认USART1_IRQHandler的地址是否为用户函数地址。

步骤4：检查HAL库回调重定向

HAL库采用“中断服务函数→HAL_XXX_IRQHandler→回调函数”的分层设计。用户常重写回调函数（如HAL_UART_RxCpltCallback），但若未在IRQHandler中调用HAL_UART_IRQHandler，回调也不会执行。

// 用户需确保中断服务函数调用HAL处理函数
void USART1_IRQHandler(void) {
    HAL_UART_IRQHandler(&huart1);  // 必须调用
}

// 回调函数重写（无需__weak）
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
    // 用户代码
}

注意：HAL_UART_RxCpltCallback在HAL库中定义为__weak，用户重写时不能加__weak。

步骤5：使用调试器验证

在Default_Handler中设置断点，若中断触发后停在此处，证实弱符号未覆盖。
在用户IRQHandler中设置断点，若未命中，检查向量表偏移（如SCB->VTOR是否指向正确地址）。

完整代码示例

以下以USART1接收中断为例，展示正确重定向流程。

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

UART_HandleTypeDef huart1;

void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_USART1_UART_Init(void);

int main(void) {
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();

    uint8_t rx_data;
    HAL_UART_Receive_IT(&huart1, &rx_data, 1);  // 启动中断接收

    while (1) { }
}

// 重写中断服务函数（强符号）
void USART1_IRQHandler(void) {
    HAL_UART_IRQHandler(&huart1);
}

// 重写回调函数（强符号）
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
    if (huart->Instance == USART1) {
        // 处理接收数据
        HAL_UART_Receive_IT(&huart1, &rx_data, 1);  // 重新使能
    }
}

static 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;
    HAL_UART_Init(&huart1);
}

注意事项

函数名严格匹配：启动文件中的中断向量名必须与用户函数名完全一致，包括大小写。
避免重复定义：若多个文件定义同名中断函数，链接器报错“multiple definition”。
回调函数无需__weak：用户重写HAL回调时直接定义即可，加__weak会导致覆盖失败。
检查启动文件版本：不同STM32系列启动文件命名略有差异（如startup_stm32f103xb.s），确保使用对应型号。
中断优先级配置：即使重定向正确，若未使能中断或优先级配置错误，中断仍不响应。使用HAL_NVIC_EnableIRQ和HAL_NVIC_SetPriority。
调试技巧：利用__weak符号的地址对比，快速判断是否重定向成功。

STM32 HAL库中__weak函数重定向导致中断不响应的排查路径