点击上方"蓝字"关注我们
01、Heob 是 what?
绝大部分的文章都说Heob是一个内存泄漏分析工具,其实Heob只是内存泄漏分析功能比较突出,实际上Heob可以分析很多内存问题。
Heob是一个Windows下检测缓冲区溢出(野指针、空指针、内存越界、重复释放、异常捕获等)和内存泄漏的工具,集成到Qt Creator中,功能强大,简单容易上手。
支持MSVC和MinGW编译器编译的程序内存泄漏检测;
支持32位和64位程序;
不支持Linux;
支持设置过滤内存泄漏字节大小;
支持异常处理;
支持与Qt调试器、事后调试器联动;
支持将分析结果导出位xml文件,后续通过加载xml文件查看分析结果;
Qt Creator支持4.6以上版本,低版本没有这个功能,可以自行安装高版本的QtCreator(注意:不是Qt版本,是IDE版本)。
处理速度块,占用资源少。
02、Qt Heob用法
方法1:使用Heob分析MSVC编译生成的程序,对于 PDB 调试信息,使用 dbghelp.dll,速度快;
方法2:使用Heob分析MinGW编译生成的程序, 对于DWARF 调试信息 (gcc) ,需要下载dwarfstack.dll库到Heob路径下才可以使用,性能会低很多;
编辑
方法3:使用Heob分析MinGW编译生成的程序,通过cv2pdb将DWARF 转成PDB进行分析,性能和分析MSVC编译的程序差不多。
方法4:命令行运行。
注意:
MSVC版本<=2017时,Heob检测会出现误报,将内存泄漏包位外部错误的内存泄漏,所以如果使用的编译器版本比较低,过滤设置时就需要勾选上外部错误 项;
对MinGW和MSVC支持不同,有些情况使用MSVC编译器可以检测出来,使用MinGW检测不出来,有些情况相反。
运行Heob前需要保证代码已经完成编译并生成了可执行程序。
03、开始表演
环境 版本
系统 Windows11
开发环境 Qt5.9、Qt5.12.12、Qt5.14.2、Qt6.8
IDE Qt Creator 5、Qt Creator 10、Qt Creator 14、 Qt Creator 15
编译器 mingw730_64、mingw1310_64、MSVC2015-64、 MSVC2017-64、MSVC2022-64
分析工具 Heob 4.0
依赖库 dwarfstack 2.2
| Heob 4.0下载 | github.com/ssbssa/heob |
| 依赖库下载 | github.com/ssbssa/dwar… |
04、配置
- 下载Heob 4.0和dwarfstack 2.2 解压到同一个文件夹中;
- 打开Qt Creator,选中【分析】【Heob】;
编辑
打开
编辑
打开Heob窗口后点击【浏览】选择Heob路径,然后点击右下角图标保存配置。
编辑
报错
编辑
可能是还没编译成.exe不管了,我们下载一个现成的看看
编辑
可以了
编辑
可以了
编辑
编辑
05、测试
创建一个Qt工程,测试代码如下所
编辑
编辑
#include "mainwindow.h"#include "ui_mainwindow.h"#include <QDebug>#include <QMessageBox>MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) , ui(new Ui::MainWindow){ ui->setupUi(this);}MainWindow::~MainWindow(){ delete ui;}class Test{public: Test() { p = new int; }private: int* p;};/** * @brief 内存泄漏1 */void MainWindow::on_pushButton_clicked(){ Test* test = new Test(); free(test);}void fun(){ for(int i = 0; i < 1024; i++) { int*p = new int[1000]; qDebug() << p[1]; }}/** * @brief 内存泄漏2 */void MainWindow::on_pushButton_2_clicked(){ fun();}/** * @brief 野指针1 */void MainWindow::on_pushButton_3_clicked(){ int* p = new int; delete p; *p = 123;}/** * @brief 野指针2 */void MainWindow::on_pushButton_4_clicked(){ int* p; *p = 123;}/** * @brief 空指针 */void MainWindow::on_pushButton_5_clicked(){ int* p = nullptr; *p = 123;}/** * @brief 内存越界 */void MainWindow::on_pushButton_6_clicked(){ int*p = new int[12]; p[123] = 123; p[12] = 1234; delete[] p;}/** * @brief 重复释放 */void MainWindow::on_pushButton_7_clicked(){ int*p = new int[12]; p[1] = 123; delete[] p; delete[] p;}/** * @brief 抛出异常 */void MainWindow::on_pushButton_8_clicked(){ throw 123;}/** * @brief 成员数组添加数据 */void MainWindow::on_pushButton_9_clicked(){ for(int i = 0; i < 10000; i++) { m_list.append(new int); qDebug() << i; }}QList<int*> g_list;/** * @brief 全局数组添加数据 */void MainWindow::on_pushButton_10_clicked(){ for(int i = 0; i < 10000; i++) { g_list.append(new int); qDebug() << i; }}/** * @brief 释放内存 */void MainWindow::on_pushButton_11_clicked(){ for(int i = 0; i < m_list.count(); i++) { delete m_list[i]; } for(int i = 0; i < g_list.count(); i++) { delete g_list[i]; } m_list.clear(); g_list.clear(); QMessageBox::about(this, "注意!", QString("已经释放内存:%1 %2").arg(m_list.count()).arg(g_list.count()));}
06、功能使用说明
$ heob64.exe -h
Usage: heob64 [OPTION]... APP [APP-OPTION]...
-oX heob output [1]
-PX show process ID and wait [0]
-cX create new console [0]
-pX page protection [1]
-fX freed memory protection [0]
-dX monitor dlls [3]
-hX handle exceptions [1]
-RX raise breakpoint exception on allocation # [0]
-rX raise breakpoint exception on error [0]
-FX show full path [0]
-lX show leak details [1]
-zX minimum leak size [0]
-kX control leak recording [0]
-LX show leak contents [0]
-H[H] show full help
heap-observer 3.1 (64bit)
`heob64.exe` 是一个用于堆内存观察的工具,通常用于调试内存泄漏和其他内存相关的问题。以下是命令行选项的详细解释:- `-oX`:设置堆观察器的输出方式。`X` 是一个数字,表示不同的输出级别。默认值为 `1`。- `-PX`:显示进程 ID 并等待。`X` 是一个数字,表示是否启用此功能。默认值为 `0`(禁用)。- `-cX`:为应用程序创建一个新的控制台窗口。`X` 是一个数字,表示是否启用此功能。默认值为 `0`(禁用)。- `-pX`:设置页面保护级别。`X` 是一个数字,表示不同的保护级别。默认值为 `1`。- `-fX`:设置释放内存的保护级别。`X` 是一个数字,表示不同的保护级别。默认值为 `0`(禁用)。- `-dX`:监控动态链接库(DLL)的加载和卸载。`X` 是一个数字,表示不同的监控级别。默认值为 `3`。- `-hX`:处理异常。`X` 是一个数字,表示是否启用此功能。默认值为 `1`(启用)。- `-RX`:在分配内存时触发断点异常。`X` 是一个数字,表示是否启用此功能。默认值为 `0`(禁用)。- `-rX`:在发生错误时触发断点异常。`X` 是一个数字,表示是否启用此功能。默认值为 `0`(禁用)。- `-FX`:显示完整路径。`X` 是一个数字,表示是否启用此功能。默认值为 `0`(禁用)。- `-lX`:显示内存泄漏的详细信息。`X` 是一个数字,表示是否启用此功能。默认值为 `1`(启用)。- `-zX`:设置最小内存泄漏大小。`X` 是一个数字,表示最小泄漏大小。默认值为 `0`。- `-kX`:控制内存泄漏记录。`X` 是一个数字,表示不同的控制级别。默认值为 `0`(禁用)。- `-LX`:显示内存泄漏的内容。`X` 是一个数字,表示是否启用此功能。默认值为 `0`(禁用)。- `-H[H]`:显示完整的帮助信息。`H` 可以重复使用以显示更详细的帮助。### 示例用法假设你想调试一个名为 `myapp.exe` 的应用程序,并希望启用内存泄漏检测和详细输出,可以使用以下命令:```bashheob64.exe -o1 -l1 myapp.exe```这将启动 `myapp.exe` 并在程序结束时显示内存泄漏的详细信息。### 注意事项- 使用 `heob64.exe` 时,建议在调试环境中运行,以便更好地捕获和分析内存问题。- 某些选项可能会影响程序的性能,因此在生产环境中使用时要谨慎。如果你需要更详细的帮助信息,可以使用 `-HH` 选项来查看完整的帮助文档。
点击【新建/删除】可以创建新的配置文件;
点击右下角软盘图标可以保存配置,配置文件保存在QtProject\leaks.xml文件中;
点击【OK】开始进行分析。
Heob Path:下载解压的Heob.exe文件路径;
XML output file: 生成的xml文件名称,使用的相对路径,在可执行程序路径下,后续可通过【调试】窗口中的文件夹图标加载生成的xml文件;
编辑
如果想更改目录这样操作
编辑
08、Handle exceptions
开关的作用:
编辑
Handle exceptions:设置出现异常时的处理方式
1.设置为On则使用Heob处理,出现异常时程序退出,在调试窗口显示出现异常的信息;
编辑
点击OK测试
弹出界面
编辑
【黑色界面后面再说】我们测试一下按钮,记得勾选需要捕获的异常
编辑
2.设置为Off则在出现异常时,会使用事后调试器进行调试。
编辑
【点击OK】
编辑
【设置一下】在使用 Qt Creator 进行崩溃后的调试(post-mortem debugging)
编辑
点击【空指针】弹出,点击默认
编辑
弹出
编辑
关闭窗口都会生成一个文件
编辑
我们复制所有文件内容,丢给fitcode的AI分析一下。
通过GDB也可以测试这些问题
编辑
gif
编辑
3.设置为Only则禁用所有Heob功能,除了安装异常处理程序。如果应用程序崩溃,则只显示崩溃的堆栈跟踪,不检测内存泄漏。因此,当在控制台上使用Heob或为子进程运行Heob时,此选项非常有用。
略
9、Run with debugger
Run with debugger: 勾选上后会以Debug调试模式运行,当出现异常(例如空指针野指针)时会触发断点,定位到出现异常的位置;
编辑
编辑
光标跳动位置就是问题点
编辑
10、Raise breakpoint exception on error
Raise breakpoint exception on error:表示出现异常时触发断点,(主要用于重复释放)
1.如果没勾选,则出现重复释放、内存越界等问题时,不会触发异常断点,会将检测结果写入文件;【写入文件-勾选】
编辑
【文件自己分析】
2.如果勾选上后,并且勾选了Run with debugger,则出现重复释放、内存越界等问题时,将会触发异常断点;【只用这个可以检查空指针、野指针等】
编辑
gif
11、Page protection
Page protection: 这个功能更适合用于检测内存越界、野指针;
1.选择OFF时更适合检测内存泄漏;
2.选择After后会在分配的内存块末尾设置一个保护页,当访问到这个保护页时就会触发异常,从而识别出野指针、内存越界;
编辑
【点击】
编辑
编辑
【定位成功】
3.选择Before则会再分配的内存块前设置一个保护页;
这个功能会消耗内存、降低检查速度,建议仅用于64位或短时间运行的程序。
12、Freed memory protection
- Freed memory protection: 这个功能会增加释放内存保护功能,已经释放的内存就不会再被使用,对于检测野指针、重复释放问题有用,但是会大量消耗内存。
编辑
点击内存越界,自动定位到这里
编辑
13、Leak details
Leak details: 这个选项用于设置程序退出时融合处理收集到的内存泄漏数据,不同的设置影响分析结果和处理速度;
None:表示不收集内存泄漏数据,所以退出时速度最快;
Simple:表示将所有未释放的内存写入结果文件,速度最慢,生成的xml文件也最大,所有内存泄漏分析结果都会被记录为16 bytes in 1 blocks are lost in loss record 196 of 209 (#2513),无法通过过滤器进行过滤;
Detect Leak Types:会记录所有确定的直接内存泄漏、间接内存泄漏到文件中,速度会快一些;
Detect Leak Types (Show Reachable) :除了记录所有确定的直接内存泄漏、间接内存泄漏到文件中,还会将可能存在内存泄漏的结果记录到文件中,可以通过过滤器中【可能的内存泄漏】选项过滤;Fuzzy
Detect Leak Types:选择模糊检测泄漏类型来标记内存块,或者它们是否引用了任何地址。当使用一些自定义分配器(例如:ffmpeg的av_malloc())时,此选项很有用,检测结果最少,只保留最有可能内存泄漏的记录,速度快,生成的文件小;
Detect Leak Types (Show Reachable) :与Fuzzy Detect Leak Types类似,不过会将其它的记录认为是可能存在的内存泄漏,也会记录到文件中,可以通过过滤器中【可能的内存泄漏】选项过滤。
【具体每一个效果怎么样,大家多训练】这里只是演示一下
编辑
14、Minimum leak size
- Minimum leak size: 设置记录内存泄漏的最小字节数,低于设置值的内存泄漏不会被记录;
15、Control leak recording
Control leak recording:控制记录内存泄漏的开关、记录时间段等,更加灵活的记录分析内存泄漏的功能(例如记一个数组不断添加堆内存数据,很长一段时间才会释放一次,这种就是特殊情况的内存泄漏,就可以通过n/f快捷键来控制检测);
OFF:关闭终端,始终开启内存泄漏记录;
On (Start Disabled) :打开终端,Heob启动时不记录内存泄漏,可在终端中进行控制;
On (Start Enabled) :打开终端,Heob启动时就开始记录内存泄漏,并且可在终端中进行控制。
编辑
16、Extra arguments
用于输入运行其它Heob参数,例如输入
-vleaks.svg会将检测结果生成svg矢量图;
编辑
编辑
编辑
编辑
17、带大家实操一遍
【1】使用Heob分析qt 程序 内存泄漏
打开测试代码,使用MSVC编译器、Debug模式进行编译,保留pdb符号表;
编译生成可执行程序;
点击【分析】【Heob】【OK】启动程序进行分析;
当程序运行后分别点击【泄漏1】【泄漏2】按键,然后退出程序,程序退出后会将分析结果生成位leaks.xml文件,并在调试窗口显示检测到的内存泄漏;
生成的检测结果会有许多动态库中的误报,可以点击调试窗口上的过滤图标,取消勾选【外部错误】项(如果MSVC版本<=2017则勾选外部错误);
编辑
编辑
检测结果如下所示,出现两个内存泄漏,大小分别是409600字节和16字节。
编辑
【2】使用Heob检测qt 程序 野指针/内存越界
- 打开Heob窗口;
- 将Page protection选为【After】或者【Before 】;
- 点击开始检测,运行野指针代码就可以成功捕获到野指针异常。
- 由于野指针、内存越界都是不可恢复的异常,所以检测到这类异常后会直接终止Heob。
编辑
使用Heob检测qt 程序 空指针 /throw抛出异常
打开Heob窗口;
使用默认设置;
点击开始检测,运行野指针代码就可以成功捕获到空指针、抛出异常。
由于空指针异常无法恢复,检测到后会终止Heob;
如果throw抛出异常后没有被try捕获,则会被Heob检测到,并触发终止,如果被try捕获,则Heob无法检测。
编辑
编辑
使用Heob检测qt 程序 重复释放
打开Heob窗口;
勾选Raise breakpoint exception on error: 表示出现异常时触发断点,如果不勾选就只会保存到检测结果;
再勾选Run with debugger ,在出现重复释放异常时,就会触发断点,进入调试。
编辑
编辑
编辑
使用Heob检测qt 程序 长生命周期式内存泄漏
这里的长生命周期式内存泄漏不同于普通内存泄漏使用new分配了而没有delete;
长生命周期内存泄漏指使用new分配了内存,过了很长时间才会delete,例如成员指针、全局变量、静态变量等;
这类内存泄漏会更加难以排查,也容易造成严重问题。
测试方法1: 无法检测到长生命周期内存泄漏
打开Heob进行检测;
点击按键,向成员数组中new大量变量;
过一段时间后再释放成员数组中的所有内存;
无法检测到出现内存泄漏;
编辑
编辑
测试方法1: 无法检测到长生命周期内存泄漏
打开Heob窗口;
如下图所示,选择Detect Leak Types(不必须),避免文件写入太多内存,检测大小设置为500字节(不必须),选择On(Start Disabled),在程序启动前不记录,在运行过程中通过终端命令行控制开始/结束记录的时机;
编辑
点击【OK】启动Heob;
程序运行后按下
n键开始记录;
编辑
然后在程序中分别给成员数组、全局数组分配内存;
编辑
在终端按下
f键停止记录,并按下s键将当前内存泄漏分析结果写入文件;
编辑
编辑
然后点击按键释放数组分配的内存;
编辑
编辑
退出程序后就可以看见检测到的内存泄漏了。
在这里操作
编辑
编辑
| Heob源地址(需要自己编译成.exe) | github.com/ssbssa/heob |
| 下载dwarfstack.dll | github.com/ssbssa/dwar… |
| Qt官方文档 | doc.qt.io/qtcreator/c… |
| Qt官方文档 | doc.qt.io/qtcreator/c… |
总结
所有资源获取
通过网盘分享的文件:Heob
链接: pan.baidu.com/s/1nA09RLDW… 提取码: td25
有帮助的话,点击一下【喜欢作者】