MCU开发常见软件BUG总结（持续更新）

数值溢出

定义变量时使用了不当的数据类型，最常见的，使用uint8_t定义时间戳的年份信息，那最多只能记载到曹魏正元二年（公元255年）的历史了。

如上图，调试器读数结果为1900+70=178，

原因就是定义RtcTime结构体时直接用tab补全没有仔细看year这个成员变量的类型。

函数命名规范

中断向量表里面的函数，在外部进行重定义时必须一字不差！

之前犯过小写错第一个s的低级错误，会导致系统的Systick中断功能性失效。

编译器差异

之前在用STM32CubeIDE时遇到过一个问题，为什么一样串口重定向的代码，在Keil上面编译下载能跑，在CubeIDE上没用呢？这是一个典型的编译器不同造成的问题，CubeIDE默认使用arm-none-eabi-gcc编译，不同于keil的ARM Clang，gcc遵循posix标准。在当前遇到的这个问题面前，我们需要重写_write函数。

原定义：

外部实现：

指针访问非法内存

这是一个非常大的概念，而且是新手很容易犯的错误，不会正确用指针的人，只能打杂（自我介绍），并且被AI替代（骗你的会用了照样被替代）。

指针函数是最容易被忽略的，尤其是我当前使用的裸机调度架构程序，

cpp 复制代码

static void (*g_pTaskScheduleFunc)(void);  //函数指针变量，保存任务调度的函数地址

/**
***********************************************************
* @brief 注册任务调度回调函数
* @param
* @return 
***********************************************************
*/
void TaskScheduleCbReg(void (*pFunc)(void))
{
  g_pTaskScheduleFunc = pFunc;
}

/**
***********************************************************
* @brief 定时中断服务函数,1ms产生1次中断
* @param
* @return 
***********************************************************
*/
void SysTick_Handler(void)
{
  g_sysRunTime++;
  g_pTaskScheduleFunc();
}

在Systick中断里面注册任务函数，这种错误很容易导致系统刚跑起来就进入了HardFault。

对滴答定时器进行了初始化但是现在没有指针函数传入了。

目标状态下应该1秒1次打印Hello World,然而系统却一直在重复复位。

并且逐步调试时发现单片机进入了HardFault：

没有正常初始化堆空间

非必要情况下，不推荐在单片机代码中使用malloc\free开辟堆空间，如需使用请养成随手初始化的好习惯。

正确演示：

cpp 复制代码

// 定义一个32字节的测试结构体
typedef struct
{
    uint8_t data[32];
} TestStruct_t;

// 计算数组所有字节的累加和
static uint32_t CalculateSum(const uint8_t *pData, uint16_t length)
{
    uint32_t sum = 0;
    for(uint16_t i = 0; i < length; i++)
    {
        sum += pData[i];
    }
    return sum;
}

// 打印数组内容
static void PrintArray(const char *name, const uint8_t *pData, uint16_t length)
{
    printf("\r\n=== %s (Length: %d bytes) ===\r\n", name, length);
    for(uint16_t i = 0; i < length; i++)
    {
        printf("data[%2d] = 0x%02X\r\n", i, pData[i]);
    }
}
int main(int argc, char *argv[])
{
	DrvInit();
    AppInit();

    uint8_t image[4]={0x01,0x02,0x03,0x04};
    uint32_t sum=0;
    
    TestStruct_t *pTestStruct = (TestStruct_t *)malloc(sizeof(TestStruct_t));
    memset(pTestStruct, 0, sizeof(TestStruct_t));
    memcpy(pTestStruct->data, image, sizeof(image));
    PrintArray("TestStruct", pTestStruct->data, sizeof(pTestStruct->data));
    sum=CalculateSum(pTestStruct->data, sizeof(pTestStruct->data));


	for(;;)
	{
       //TaskHandler();
       printf("sum=%d\r\n",sum);
       DelayNms(1000);
    }
}

PS：这里为了设计实验没有free，不过大小被写死了大家别学就行。

正确结果：

计算结果符合预期：

错误示范：

可以看到Clangd已经在提示我们别做傻事了：

无视警告的话就会获得一个带有随机脏数据的数组：

------------------------------------------------未完待续------------------------------------------------