BugTrap：程序崩溃快照、bug跟踪之利器

BugTrap的github官网地址：https://github.com/bchavez/BugTrap

下载源码解压后可直接进行编译，

这里提供一下编译好的dll及lib文件（Unicode版本，如需其他版本请自行下载源码编译）。

效果预览（当程序崩溃时）：




点“详情”：


点“预览”：



BugTrap使用方法：

BOOL CMarketInfoApp::InitInstance()
{
	...

	SetRegistryKey(_T("应用程序向导生成的本地应用程序"));

	// 开启程序崩溃感知
	SetUnhandledExceptionFilter(MyUnhandledExceptionFilter);
	
	...
}

逻辑处理MyBugTrap.cpp：

#include "stdafx.h"
#include "BugTrap\BugTrap.h"
#include "MyBugTrap.h"

static void SetupExceptionHandler()
{
	LOG_TRACER();
	
	BT_InstallSehFilter();

	// 配置信息
    BT_SetAppName(_T("MarketInfo"));
	BT_SetDialogMessage(BTDM_INTRO1, _T("We're so Sorry, program crashed because of our mistakes !"));
	BT_SetDialogMessage(BTDM_INTRO2, _T("本程序会尝试收集仅与此次异常崩溃相关的数据，请将此报告发送给我们以便帮助我们开发体验更好的产品，给您造成的不便之处敬请谅解！"));
    BT_SetSupportEMail(_T("futures_bugreport@tsingfun.com"));
	// BTF_DETAILEDMODE：崩溃时记录dump文件，不设置的话报告中没有dump文件
	// BTF_ATTACHREPORT：点”发送到“可以通过带附件的邮件发送报告
	// BTF_SCREENCAPTURE：错误报告中附带一张崩溃时屏幕截图

	// BTF_EDITMAIL：点”发送到“可以发送邮件到指定地址(没有附件，不可更改目的地址)
	// BTF_LISTPROCESSES：列出崩溃时所有的进程信息(速度较慢)
	// BTF_SHOWADVANCEDUI：崩溃后默认显示详细对话框(不设置的话，先显示简单对话框，有查看详细的按钮)	
	// BTF_DESCRIBEERROR：发送报告之前弹出问题描述对话框，让用户输入错误描述信息
	BT_SetFlags(BTF_DETAILEDMODE | BTF_ATTACHREPORT | BTF_SCREENCAPTURE);
    BT_SetSupportServer(_T("www.tsingfun.com"), 9999);
    BT_SetSupportURL(_T("https://www.tsingfun.com"));

	// 最新的Log文件附上
	TCHAR szLogFile[MAX_PATH] = { 0 };
	GetCurrentDirectory(MAX_PATH, szLogFile);
	SYSTEMTIME sys;
	GetLocalTime(&sys);

	_stprintf_s(szLogFile, _T("%s\\logs\\%4d%02d%02d.log"), szLogFile, sys.wYear, sys.wMonth, sys.wDay);
	BT_AddLogFile(szLogFile);

	//自动保存crash文件
	//BT_SetReportFilePath(_T("crash"));
	//BT_SetActivityType(BTA_SAVEREPORT);
}

// Windows下感知程序崩溃的方法有3个核心的函数，分别如下：
//	SetUnhandledExceptionFilter   (HandleException)确定出现没有控制的异常发生时调用HandleException.
//	_set_invalid_parameter_handler(HandleInvalidParameter)确定出现无效参数调用发生时调用HandleInvalidParameter.
//	_set_purecall_handler         (HandlePureVirtualCall)确定纯虚函数调用发生时调用HandlePureVirtualCall.

// Example: SetUnhandledExceptionFilter(TFUnhandledExceptionFilter); *((int*)0x0) = 0;

LONG WINAPI MyUnhandledExceptionFilter(PEXCEPTION_POINTERS pExceptionPointers)
{
	LOG_TRACER();

	SetupExceptionHandler();
	return EXCEPTION_CONTINUE_EXECUTION;
}

若不想弹出崩溃信息对话框，直接将崩溃包保存文件，只需将上述代码改为：

static void SetupExceptionHandler()
{
	LOG_TRACER();
	
	BT_InstallSehFilter();

	// 配置信息
    BT_SetAppName(_T("MarketInfo"));
	
	//自动保存crash文件
	BT_SetReportFilePath(_T("crash"));
	BT_SetActivityType(BTA_SAVEREPORT);
}

生成崩溃zip包如下（dmp是zip解压出来的）：


双击dmp文件，使用vs打开：


进行调试，如下：

这样便可还原崩溃现场，进行跟踪调试快速找出bug。

崩溃文件上传，服务器端下载配置请参见《BugTrap程序崩溃快照上传服务端开发配置》。

英文资料请参见：《Catch All Bugs with BugTrap!》