调试遇‘free(): double free detected in tcache 2’错误，求排查思路

• 核查节点创建与插入逻辑

  • 确认是否存在同一节点指针被重复插入哈希表的情况，比如将同一个node*多次加入不同桶或同一桶的链表，导致unload时多次释放同一块内存
  • 检查插入操作中是否有内存指针赋值错误，比如误将已分配节点的地址赋值给多个链表节点，造成多位置指向同一块动态内存

• 验证哈希表桶数量N的正确性

  • 确认N的值与哈希表实际的桶数量完全一致，避免循环范围错误导致访问未初始化的table[i]（野指针），这类野指针可能指向已被释放的内存区域，触发双重释放报错

• 检查节点结构体的内存分配细节

  • 如果node结构体内部包含其他动态分配的成员（比如字符串缓冲区），需确认是否存在其他代码提前释放了这些子内存，或unload函数未按正确顺序释放（应先释放子内存，再释放节点本身），这类操作也可能引发内存错误

• 增加日志定位问题

  • 由于调试器被报错终止，可在free前后添加地址打印日志，直接观察被释放的内存地址是否重复：

    printf("Freeing node: %p\n", table[i]);
    free(table[i]);
    

    若日志中出现重复的内存地址，即可直接定位到重复释放的位置

• 排查哈希表的跨函数操作

  • 检查是否有其他函数（比如删除、清理类函数）在unload执行前后，对哈希表节点执行过free操作但未将对应table指针置空，导致unload再次释放已失效的指针

• 确认哈希表初始化完整性

  • 验证哈希表初始化时是否将所有table[i]都正确置为NULL，未初始化的野指针可能指向内存中已释放的旧数据，被unload误判为有效节点进行释放

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