AddressSanitizer可快速定位“free(): invalid pointer”错误,它在非法释放发生时立即报错并输出调用栈、非法地址及释放位置;编译需加-fsanitize=address -g -O0,注意避免栈内存、字面量、混用分配/释放函数等典型误操作。

用 AddressSanitizer 快速定位非法指针释放
“free(): invalid pointer” 通常不是 free() 自身出错,而是之前对指针的误操作(比如释放了栈内存、重复释放、释放了未 malloc 的地址)破坏了堆管理器的元数据。AddressSanitizer(ASan)是目前最有效的第一排查工具,它能在非法释放发生时立刻报错并给出调用栈。
编译时加 -fsanitize=address -g,例如:
g++ -fsanitize=address -g -O0 main.cpp -o main
运行后会直接打印错误位置、被释放的非法地址、以及从哪行代码调用了 free() 或 delete。注意:-O0 可避免优化干扰符号信息;若项目含 C++17+ 的 std::pmr 或自定义分配器,ASan 可能不完全覆盖,需额外验证。
检查是否释放了栈对象或字面量地址
这类错误非常常见,但 ASan 有时只报“invalid pointer”,不提示来源。典型场景包括:
立即学习“C++免费学习笔记(深入)”;
- 对局部数组取地址后传给
free():int buf[1024]; free(buf); - 释放字符串字面量:
char* p = "hello"; free(p); - 误用
delete释放malloc()分配的内存,或反过来
关键判断依据:只有 malloc/calloc/realloc 返回的地址才能传给 free();只有 new 返回的地址才能传给 delete。混用必然触发 undefined behavior,且多数 libc 实现会立即 abort 并输出该错误。
确认是否重复释放或释放后继续使用
重复释放同一块堆内存,大概率在第二次 free() 时报 “invalid pointer”。原因在于第一次释放后,glibc 的 malloc 实现会将该 chunk 标记为可用,并可能修改其前后指针字段——再次释放时校验失败。
排查建议:
- 用
valgrind --tool=memcheck --leak-check=full ./main运行,它会明确指出 “Invalid free() / delete / delete[]” 并标注首次和二次释放位置 - 在每次
free()后手动置空指针:free(p); p = nullptr;,后续若误用free(p)就变成free(nullptr)(安全,无效果) - 避免裸指针管理资源,优先用
std::unique_ptr或std::shared_ptr,它们自动处理释放逻辑
留意多线程环境下的释放竞争
如果程序是多线程的,一个线程刚 free() 完某块内存,另一个线程同时用 free() 或访问该地址,也可能触发此错误。ASan 默认不检测线程竞争,需改用 ThreadSanitizer:
g++ -fsanitize=thread -g -O0 main.cpp -o main
TSan 会报告 data race,尤其关注对同一指针变量的读写冲突。但要注意:TSan 与 ASan 不能共存,必须分开编译测试。另外,某些低层库(如部分网络库的 buffer pool)若未正确加锁,也容易在此类场景下暴露问题。
真正棘手的是跨模块释放:比如 A 模块用 malloc 分配,B 模块(链接不同 libc 版本或静态/动态混用)调用 free —— 这种情况错误信息可能不明确,得靠 ldd + nm 确认符号绑定来源。


















