在上篇文章《让程序在崩溃时体面的退出(5):SEH+Dump文件》介绍了怎样用SEH加上Dump文件来避免程序的崩溃并在程序崩溃时创建Dump文件来帮助定位出现异常的代码行。可是只有try/except块中try块中的代码出现异常才能被捕捉到,try块外面的代码出现异常,程序照样会崩溃。
下面用《让程序在崩溃时体面的退出(5):SEH+Dump文件》文中的代码为例子来说明。
// 创建Dump文件
//
void CreateDumpFile(LPCWSTR lpstrDumpFilePathName, EXCEPTION_POINTERS *pException)
{
// 创建Dump文件
//
HANDLE hDumpFile = CreateFile(lpstrDumpFilePathName, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
// Dump信息
//
MINIDUMP_EXCEPTION_INFORMATION dumpInfo;
dumpInfo.ExceptionPointers = pException;
dumpInfo.ThreadId = GetCurrentThreadId();
dumpInfo.ClientPointers = TRUE;
// 写入Dump文件内容
//
MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), hDumpFile, MiniDumpNormal, &dumpInfo, NULL, NULL);
CloseHandle(hDumpFile);
}
// 作为except块中表达式的函数
//
LONG CrashHandler(EXCEPTION_POINTERS *pException)
{
// 在这里添加处理程序崩溃情况的代码
//
// 这里以弹出一个对话框为例子
//
MessageBox(NULL, _T("Message from Catch handler"), _T("Test"), MB_OK);
// 创建Dump文件
//
CreateDumpFile(_T("C:\\Test.dmp"), pException);
return EXCEPTION_EXECUTE_HANDLER;
}
int _tmain(int argc, _TCHAR* argv[])
{
__try
{
MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);
// 除零,人为的使程序崩溃
//
int i = 13;
int j = 0;
int m = i / j;
}
// 捕捉到让程序崩溃的异常时创建Dump文件
//
__except(CrashHandler(GetExceptionInformation()))
{
// 这里以弹出一个对话框为例子
//
MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);
}
MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);
return 0;
}
编译上面的代码并运行,会依次弹出下面这些对话框,并在C盘创建一个Dump文件Test.dmp。
如果把上面代码中的main()函数改成下面的样子,运行编译后的程序依然会崩溃。
int _tmain(int argc, _TCHAR* argv[])
{
__try
{
MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);
// 除零,人为的使程序崩溃
//
int i = 13;
int j = 0;
int m = i / j;
}
// 捕捉到让程序崩溃的异常时创建Dump文件
//
__except(CrashHandler(GetExceptionInformation()))
{
// 这里以弹出一个对话框为例子
//
MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);
}
// 除零,人为的使程序崩溃
//
int i = 13;
int j = 0;
int m = i / j;
MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);
return 0;
}
这种情况在实际编程中是很有可能出现的,毕竟我们不可能事先预计到所有可能出现导致程序崩溃的情况,并把这些代码放到try/except块中。那么对于这些不可预知的异常该怎么办呢?这就要用到我那篇《让程序在崩溃时体面的退出之Unhandled Exception》中的方法:用Windows API中的SetUnhandledExceptionFilter设置一个回调函数来处理这些无法预料的异常。下面是在上面的例子代码上修改后的代码。其中函数CreateDumpFile没有任何变化。
// 得到当前时间
//
wstring GetPresentTime()
{
SYSTEMTIME time;
GetLocalTime(&time);
wchar_t wszTime[128];
swprintf_s(wszTime, _T("%04d-%02d-%02d %02d-%02d-%02d-%03d"), time.wYear, time.wMonth, time.wDay, time.wHour, time.wMinute, time.wSecond, time.wMilliseconds);
return wstring(wszTime);
}
// 处理异常的回调函数
//
LONG CrashHandler(EXCEPTION_POINTERS *pException)
{
// 在这里添加处理程序崩溃情况的代码
//
// 这里以弹出一个对话框为例子
//
MessageBox(NULL, _T("Message from Catch handler"), _T("Test"), MB_OK);
// 以当前时间为文件名
//
wstring strDumpFileName = _T("C:\\") + GetPresentTime() +_T(".dmp");
// 创建Dump文件
//
CreateDumpFile(strDumpFileName.data(), pException);
return EXCEPTION_EXECUTE_HANDLER;
}
int _tmain(int argc, _TCHAR* argv[])
{
// 设置处理Unhandled Exception的回调函数
//
SetUnhandledExceptionFilter((LPTOP_LEVEL_EXCEPTION_FILTER)CrashHandler);
__try
{
MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);
// 除零,人为的使程序崩溃
//
int i = 13;
int j = 0;
int m = i / j;
}
__except(CrashHandler(GetExceptionInformation()))
{
// 在这里添加处理程序崩溃情况的代码
//
// 这里以弹出一个对话框为例子
//
MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);
}
// 除零,人为的使程序崩溃
//
int i = 13;
int j = 0;
int m = i / j;
MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);
return 0;
}
编译上面的代码,运行生成的EXE文件,可以看到在弹出上面提到的那一系列的对话框后,程序正常退出,没有崩溃。同时,在C盘下生成了2个Dump文件,文件名指出了发生异常的时刻。
上面的代码仅仅是为了说明怎样配合使用SEH和SetUnhandledExceptionFilter,所以except后的表达式和SetUnhandledExceptionFilter中所设置的回调函数都使用了同一个函数CrashHandler。在实际的应用中可以根据不同的需求而使用不同的函数。这个函数的参数必须是一个指向EXCEPTION_POINTERS的指针,返回值必须是这3个中的一个:EXCEPTION_CONTINUE_SEARCH,EXCEPTION_CONTINUE_EXECUTION,EXCEPTION_EXECUTE_HANDLER。这3个值的具体含义可以查阅MSDN或者我的那篇《让程序在崩溃时体面的退出(4):SEH》。
实际情况下,是不应该用同一个回调函数的。因为在except表达式中的函数是处理try块中的代码异常的;而用SetUnhandledExceptionFilter设置的回调函数是用来处理代码中没有被捕捉到的异常的。对于未被捕捉到的异常,这个回调函数是不知道异常发生的地方的,虽然可以通过异常代码知道异常的类型,但是由于不知道是什么状况引起的异常,所以没法做出相应的异常处理。一般情况下,这个回调函数是应用程序崩溃前的最后一道防线,这个函数中的代码被执行完后,应用程序就会被终止。所以,大部分的应用程序,在这个函数里都是弹出一个发送错误报告的对话框,来告诉用户程序发生异常,需要终止,可以把错误报告(一般是包括Dump文件和一些必要的文本信息)发送到指定地方帮助开发者来修改代码缺陷,以提高软件质量。
使用上面的方法编写出的应用程序不会崩溃,并且在出现异常的时候会产生Dump文件。程序的使用者会获得非常良好的用户体验。如果再给应用程序添加上Log信息,配合上Dump文件,就可以很轻松的定位程序中的异常,帮助开发者快速的修复代码中的错误。