一、问题现象与背景

在STM32 HAL库项目中，常出现中断无法触发、程序跑飞或进入HardFault的现象。尤其当用户重定义了HAL库中的__weak函数（如HAL_GPIO_EXTI_Callback）后，系统可能表现为：

外部中断触发后无响应，但标志位已置位；
调试时发现中断服务函数（ISR）未被执行；
查看反汇编或map文件，发现中断向量表地址与预期不符。

这类问题往往源于**__weak函数重定向导致链接器优化或向量表偏移**。本文将逐步拆解原因并提供排查方法。

二、原理讲解：__weak与中断向量表的关系

2.1 __weak函数的作用

HAL库中大量回调函数（如HAL_UART_RxCpltCallback）被定义为__weak，允许用户在不修改库代码的情况下重定义。例如：

__weak void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
  /* 默认空实现 */
}

当用户在自己的.c文件中定义同名函数（无__weak），链接器会优先使用用户版本，覆盖弱符号。

2.2 中断向量表的生成机制

STM32启动文件（如startup_stm32f103xb.s）中定义了向量表，每个表项指向对应的中断服务函数（如EXTI0_IRQHandler）。这些ISR通常也是__weak定义，并默认跳转到Default_Handler。用户可在C文件中重定义ISR。

关键点：向量表位于Flash起始地址（如0x08000000），由链接脚本固定。但若用户重定义函数时意外修改了链接顺序或使用了__attribute__((section))，可能导致向量表被重定位或函数地址错乱。

2.3 偏移的典型原因

重定义函数未加__weak但链接器未正确覆盖：某些工具链下，弱符号覆盖可能失败，导致向量表仍指向默认处理函数。
用户自定义向量表：手动定义g_pfnVectors数组并放置到非标准段，导致SCB->VTOR未更新。
链接脚本中向量表段被移动：如使用__attribute__((section(".isr_vector")))但未在链接脚本中固定地址。
函数重定向导致代码段膨胀：大量重定义函数使代码段跨越边界，链接器将向量表挤到非对齐地址。

三、排查步骤与配置

3.1 确认向量表地址

在调试器中查看SCB->VTOR寄存器值，正常应为0x08000000（或用户指定的偏移）。若为其他值，检查启动文件或系统初始化代码中是否调用了SCB->VTOR = ...。

3.2 分析map文件

在工程生成的.map文件中搜索g_pfnVectors或.isr_vector段，确认其起始地址是否为Flash起始地址。若地址偏移，检查链接脚本（.ld或.sct）中向量表段的放置规则。

示例map片段：

.isr_vector     0x08000000     0x130
                0x08000000                g_pfnVectors

3.3 检查重定义函数

确保用户重定义的回调函数与HAL库声明完全一致（参数、返回值），且未添加static（否则链接器无法覆盖）。使用nm命令或IDE符号浏览器查看函数地址，确认用户版本已生效。

3.4 验证中断服务函数

在stm32fxxx_it.c中，确认ISR调用了正确的HAL处理函数。例如：

void EXTI0_IRQHandler(void)
{
  HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_0);
}

若用户重定义了HAL_GPIO_EXTI_Callback，需确保HAL_GPIO_EXTI_IRQHandler内部调用了该回调（HAL库已实现）。

四、完整代码示例

以下示例展示正确重定义回调并验证向量表：

/* 用户文件 user_exti.c */
#include "stm32f1xx_hal.h"

/* 重定义弱回调，注意不要加__weak */
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
  if (GPIO_Pin == GPIO_PIN_0)
  {
    HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
  }
}

/* 检查向量表地址（调试用） */
void Check_Vector_Table(void)
{
  uint32_t vtor = SCB->VTOR;
  if (vtor != 0x08000000)
  {
    // 触发断点或打印错误
    __BKPT(0);
  }
}

在main初始化后调用Check_Vector_Table()，确保VTOR正确。

五、注意事项

不要随意修改启动文件：除非必要，避免手动调整向量表段位置。
使用__weak时保持签名一致：参数类型、个数必须与库声明完全相同，否则链接器视为不同函数。
避免在重定义函数中使用static：静态函数无法覆盖弱符号。
检查链接脚本：确保.isr_vector段被放置在Flash起始地址，且未被其他段覆盖。
调试时查看反汇编：在Disassembly窗口中确认中断向量表内容指向正确的ISR地址。
使用__attribute__((used))：防止未引用的重定义函数被链接器优化掉。

通过以上方法，可系统性地定位并解决__weak函数重定向导致的中断向量表偏移问题，提升嵌入式系统的稳定性。

STM32 HAL库中__weak函数重定向导致中断向量表偏移的排查方法