ESP32项目Card类save_card函数this指针id值异常问题求助

云上老周

2026-7-24

问题排查与解决方法

问题核心

你碰到的情况是：6字节NFC标签的UID在save_card函数里会莫名变成"B"，但在loop、edition_mode这些函数里显示完全正常；4字节的UID却没这个问题。另外card对象的指针地址在三个函数里是一致的，但card->get_id()返回的内存地址在save_card里完全不一样——这说明Card类里的id字段的内存指向，在save_card里被非法篡改了，或者指向了已经被释放的无效内存。

排查方向与解决办法

1. 检查`id`的内存生命周期

如果Card的id字段是指向栈上临时数组/字符串的（比如在loop里用局部数组存UID，然后让id指针直接指向这个局部变量），那进入save_card函数后，原来函数的栈帧会被覆盖，id指针就会指向无效内存，刚好被"B"这类数据覆盖。4字节UID可能因为内存布局巧合，没被覆盖到。

解决办法：
给id分配堆内存存储，别直接用栈上的临时变量。比如在Card的构造函数里：

Card::Card(uint8_t* uid, int uid_len) {
    // 按UID长度分配堆内存（如果是十六进制字符串，每个字节占2位，加结束符）
    id = (char*)malloc(uid_len * 2 + 1);
    if (id != nullptr) {
        // 把UID字节转成字符串拷贝到堆内存里
        for (int i = 0; i < uid_len; i++) {
            sprintf(id + i*2, "%02X", uid[i]);
        }
        id[uid_len*2] = '\0';
    }
}

// 记得在析构函数里释放内存，避免泄漏
Card::~Card() {
    if (id != nullptr) {
        free(id);
    }
}

2. 排查`save_card`的栈溢出问题

ESP32默认栈空间不大（一般8KB左右），如果save_card里有大的局部数组，或者SD卡操作的缓冲区占了太多栈空间，很可能会覆盖掉Card对象的id指针指向的内存，甚至破坏Card的内部结构。6字节UID的字符串更长，更容易被溢出覆盖。

解决办法：
把save_card里的大局部变量改成静态变量，或者用堆内存分配：

void save_card(Card* card) {
    // 静态变量存在全局内存，不占栈空间
    static char write_buffer[512];
    // 或者用堆分配：char* write_buffer = (char*)malloc(512);
    sprintf(write_buffer, "ID:%s,VALUE:%d,TIME:%lu\n", card->get_id(), card->get_value(), card->get_time_saved());
    // 执行SD卡写入操作...
    // 堆分配的话记得用完释放：if (write_buffer) free(write_buffer);
}

也可以去ESP-IDF配置里调大主任务栈空间（CONFIG_MAIN_TASK_STACK_SIZE），但这只是临时办法，不如从代码上优化内存使用。

3. 检查`get_id()`的实现错误

如果get_id()返回的是栈上临时字符串的指针，那这个指针是无效的，不同函数里会指向随机内存。比如这种错误写法：

// 错误的get_id实现
char* Card::get_id() {
    char temp[20]; // 栈上临时数组，函数结束就释放
    strcpy(temp, id);
    return temp; // 返回无效指针
}

这种情况下，get_id()返回的地址在不同函数里完全不一样，内容自然随机。4字节UID可能刚好残留了正确数据，6字节的就被覆盖成"B"了。

解决办法：
改get_id()的实现，要么直接返回id的常量引用，要么让调用方提供缓冲区：

// 方法1：返回常量指针，直接指向类内的id内存
const char* Card::get_id() const {
    return id;
}

// 方法2：调用方传缓冲区，避免返回无效指针
void Card::get_id(char* buffer, int buffer_len) const {
    if (buffer && buffer_len > strlen(id)) {
        strcpy(buffer, id);
    }
}

4. 排查SD卡操作的内存干扰

SD卡的SPI操作可能会用到DMA或者占用内存总线，要是Card的id存在容易被干扰的内存区域（比如靠近DMA缓冲区的位置），可能会被意外篡改。

解决办法：
把Card对象用new创建（分配到堆内存），或者用static修饰，避开易被干扰的栈内存：

// 在loop里创建Card对象时用堆分配
Card* card = new Card(uid, uid_len);
// 用完记得delete card; 避免内存泄漏

验证步骤

直接打印card->id的内存地址（别打印get_id()的返回地址），对比三个函数里的地址——如果card指针地址一致，但card->id地址在save_card里不一样，说明id指针本身被篡改了。
刚进入save_card就打印card->get_id()，如果此时已经是"B"，说明进入函数前id就坏了；要是执行SD操作后才变，那就是SD操作导致的内存问题。
先注释掉save_card里的SD写入代码，只留打印逻辑，看id是否正常——如果正常，那就是SD操作的栈溢出或内存干扰问题。

内容的提问来源于stack exchange，提问作者Joaquin

ESP32项目Card类save_card函数this指针id值异常问题求助

问题核心 #

排查方向与解决办法 #

1. 检查id的内存生命周期 #

2. 排查save_card的栈溢出问题 #

3. 检查get_id()的实现错误 #

4. 排查SD卡操作的内存干扰 #

验证步骤 #