让程序在崩溃时体面的退出之终极解决方案（SEH+Dump+Unhandled Exception Filter）

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

view plain copy to clipboard print ?

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. } 

// 创建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()函数改成下面的样子，运行编译后的程序依然会崩溃。

view plain copy to clipboard print ?

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. } 

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没有任何变化。

view plain copy to clipboard print ?

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. } 

// 得到当前时间 // 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或者我的那篇《让程序在崩溃时体面的退出之SEH》。
        实际情况下，是不应该用同一个回调函数的。因为在except表达式中的函数是处理try块中的代码异常的；而用SetUnhandledExceptionFilter设置的回调函数是用来处理代码中没有被捕捉到的异常的。对于未被捕捉到的异常，这个回调函数是不知道异常发生的地方的，虽然可以通过异常代码知道异常的类型，但是由于不知道是什么状况引起的异常，所以没法做出相应的异常处理。一般情况下，这个回调函数是应用程序崩溃前的最后一道防线，这个函数中的代码被执行完后，应用程序就会被终止。所以，大部分的应用程序，在这个函数里都是弹出一个发送错误报告的对话框，来告诉用户程序发生异常，需要终止，可以把错误报告（一般是包括Dump文件和一些必要的文本信息）发送到指定地方帮助开发者来修改代码缺陷，以提高软件质量。

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