开发文章

使用Dump文件防止程序崩溃的方法


让程序在崩溃时体面的退出之SEH+Dump文件》介绍了怎样用SEH加上Dump文件来避免程序的崩溃并在程序崩溃时创建Dump文件来帮助定位出现异常的代码行。可是只有try/except块中try块中的代码出现异常才能被捕捉到,try块外面的代码出现异常,程序照样会崩溃。
        下面用《让程序在崩溃时体面的退出之SEH+Dump文件》文中的代码为例子来说明。

 

C/C++ Code
  1. // 创建Dump文件   
  2. //    
  3. void CreateDumpFile(LPCWSTR lpstrDumpFilePathName, EXCEPTION_POINTERS *pException)   
  4. {   
  5.     // 创建Dump文件   
  6.     //   
  7.     HANDLE hDumpFile = CreateFile(lpstrDumpFilePathName, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);   
  8.   
  9.     // Dump信息   
  10.     //   
  11.     MINIDUMP_EXCEPTION_INFORMATION dumpInfo;   
  12.     dumpInfo.ExceptionPointers = pException;   
  13.     dumpInfo.ThreadId = GetCurrentThreadId();   
  14.     dumpInfo.ClientPointers = TRUE;   
  15.   
  16.     // 写入Dump文件内容   
  17.     //   
  18.     MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), hDumpFile, MiniDumpNormal, &dumpInfo, NULL, NULL);   
  19.   
  20.     CloseHandle(hDumpFile);   
  21. }   
  22.   
  23. // 作为except块中表达式的函数   
  24. //   
  25. LONG CrashHandler(EXCEPTION_POINTERS *pException)   
  26. {      
  27.     // 在这里添加处理程序崩溃情况的代码   
  28.     //   
  29.   
  30.     // 这里以弹出一个对话框为例子   
  31.     //   
  32.     MessageBox(NULL, _T("Message from Catch handler"), _T("Test"), MB_OK);   
  33.   
  34.     // 创建Dump文件   
  35.     //   
  36.     CreateDumpFile(_T("C:\\Test.dmp"), pException);   
  37.   
  38.     return EXCEPTION_EXECUTE_HANDLER;   
  39. }   
  40.   
  41. int _tmain(int argc, _TCHAR* argv[])   
  42. {   
  43.     __try  
  44.     {   
  45.         MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);   
  46.   
  47.         // 除零,人为的使程序崩溃   
  48.         //   
  49.         int i = 13;   
  50.         int j = 0;   
  51.         int m = i / j;   
  52.     }   
  53.     // 捕捉到让程序崩溃的异常时创建Dump文件   
  54.     //   
  55.     __except(CrashHandler(GetExceptionInformation()))   
  56.     {   
  57.         // 这里以弹出一个对话框为例子   
  58.         //   
  59.         MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);   
  60.     }   
  61.   
  62.     MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);   
  63.   
  64.     return 0;   
  65. }  

编译上面的代码并运行,会依次弹出下面这些对话框,并在C盘创建一个Dump文件Test.dmp。
 

 如果把上面代码中的main()函数改成下面的样子,运行编译后的程序依然会崩溃。
C/C++ Code
  1. int _tmain(int argc, _TCHAR* argv[])   
  2. {   
  3.     __try  
  4.     {   
  5.         MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);   
  6.   
  7.         // 除零,人为的使程序崩溃   
  8.         //   
  9.         int i = 13;   
  10.         int j = 0;   
  11.         int m = i / j;   
  12.     }   
  13.     // 捕捉到让程序崩溃的异常时创建Dump文件   
  14.     //   
  15.     __except(CrashHandler(GetExceptionInformation()))   
  16.     {   
  17.         // 这里以弹出一个对话框为例子   
  18.         //   
  19.         MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);   
  20.     }   
  21.   
  22.     // 除零,人为的使程序崩溃   
  23.     //   
  24.     int i = 13;   
  25.     int j = 0;   
  26.     int m = i / j;   
  27.   
  28.     MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);   
  29.   
  30.     return 0;   
  31. }  
        这种情况在实际编程中是很有可能出现的,毕竟我们不可能事先预计到所有可能出现导致程序崩溃的情况,并把这些代码放到try/except块中。那么对于这些不可预知的异常该怎么办呢?这就要用到我那篇《让程序在崩溃时体面的退出之Unhandled Exception》中的方法:用Windows API中的SetUnhandledExceptionFilter设置一个回调函数来处理这些无法预料的异常。下面是在上面的例子代码上修改后的代码。其中函数CreateDumpFile没有任何变化。

 
C/C++ Code
  1. // 得到当前时间   
  2. //   
  3. wstring GetPresentTime()   
  4. {   
  5.      SYSTEMTIME time;   
  6.      GetLocalTime(&time);    
  7.   
  8.      wchar_t wszTime[128];   
  9.      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);   
  10.   
  11.      return wstring(wszTime);   
  12. }   
  13.   
  14. // 处理异常的回调函数   
  15. //   
  16. LONG CrashHandler(EXCEPTION_POINTERS *pException)   
  17. {      
  18.     // 在这里添加处理程序崩溃情况的代码   
  19.     //   
  20.   
  21.     // 这里以弹出一个对话框为例子   
  22.     //   
  23.     MessageBox(NULL, _T("Message from Catch handler"), _T("Test"), MB_OK);   
  24.   
  25.     // 以当前时间为文件名   
  26.     //   
  27.     wstring strDumpFileName = _T("C:\\") + GetPresentTime() +_T(".dmp");  
  28.  
  29.     // 创建Dump文件  
  30.     //  
  31.     CreateDumpFile(strDumpFileName.data(), pException);  
  32.  
  33.     return EXCEPTION_EXECUTE_HANDLER;  
  34. }  
  35.  
  36. int _tmain(int argc, _TCHAR* argv[])  
  37. {  
  38.     // 设置处理Unhandled Exception的回调函数  
  39.     //   
  40.     SetUnhandledExceptionFilter((LPTOP_LEVEL_EXCEPTION_FILTER)CrashHandler);   
  41.  
  42.     __try  
  43.     {  
  44.         MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);  
  45.  
  46.         // 除零,人为的使程序崩溃  
  47.         //  
  48.         int i = 13;  
  49.         int j = 0;  
  50.         int m = i / j;  
  51.     }  
  52.     __except(CrashHandler(GetExceptionInformation()))  
  53.     {  
  54.         // 在这里添加处理程序崩溃情况的代码  
  55.         //  
  56.  
  57.         // 这里以弹出一个对话框为例子  
  58.         //  
  59.         MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);  
  60.     }  
  61.  
  62.     // 除零,人为的使程序崩溃  
  63.     //  
  64.     int i = 13;  
  65.     int j = 0;  
  66.     int m = i / j;  
  67.  
  68.     MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);   
  69.   
  70.     return 0;   
  71. }  


编译上面的代码,运行生成的EXE文件,可以看到在弹出上面提到的那一系列的对话框后,程序正常退出,没有崩溃。同时,在C盘下生成了2个Dump文件,文件名指出了发生异常的时刻。

        上面的代码仅仅是为了说明怎样配合使用SEH和SetUnhandledExceptionFilter,所以except后的表达式和SetUnhandledExceptionFilter中所设置的回调函数都使用了同一个函数CrashHandler。在实际的应用中可以根据不同的需求而使用不同的函数。这个函数的参数必须是一个指向EXCEPTION_POINTERS的指针,返回值必须是这3个中的一个:EXCEPTION_CONTINUE_SEARCH,EXCEPTION_CONTINUE_EXECUTION,EXCEPTION_EXECUTE_HANDLER。这3个值的具体含义可以查阅MSDN或者我的那篇《让程序在崩溃时体面的退出之SEH》。
        
         实际情况下,是不应该用同一个回调函数的。因为在except表达式中的函数是处理try块中的代码异常的;而用SetUnhandledExceptionFilter设置的回调函数是用来处理代码中没有被捕捉到的异常的。对于未被捕捉到的异常,这个回调函数是不知道异常发生的地方的,虽然可以通过异常代码知道异常的类型,但是由于不知道是什么状况引起的异常,所以没法做出相应的异常处理。一般情况下,这个回调函数是应用程序崩溃前的最后一道防线,这个函数中的代码被执行完后,应用程序就会被终止。所以,大部分的应用程序,在这个函数里都是弹出一个发送错误报告的对话框,来告诉用户程序发生异常,需要终止,可以把错误报告(一般是包括Dump文件和一些必要的文本信息)发送到指定地方帮助开发者来修改代码缺陷,以提高软件质量。

        使用上面的方法编写出的应用程序不会崩溃,并且在出现异常的时候会产生Dump文件。程序的使用者会获得非常良好的用户体验。如果再给应用程序添加上Log信息,配合上Dump文件,就可以很轻松的定位程序中的异常,帮助开发者快速的修复代码中的错误。

原文标题:让程序在崩溃时体面的退出之终极解决方案(SEH+Dump+Unhandled Exception Filter)

文章信息

发布时间:2011-08-12

作者:starlee

发布者:aquwcw

浏览次数: