laravel處理異常的核心在于集中化管理和響應錯誤。1. 異常處理通過 app/exceptions/handler.php 文件實現，其中 report 方法用于記錄異常，支持多種日志驅動并可自定義邏輯；2. render 方法將異常轉換為http響應，根據環境變量顯示不同錯誤頁面，并支持自定義視圖；3. 自定義異常類如 customexception 可增強錯誤類型管理，包含構造函數和 report 方法；4. http異常可通過 abort 函數拋出預定義異常；5. try-catch 塊用于捕獲特定異常并處理，同時支持 finally 執行必要清理代碼；6. 全局中間件可用于統一處理請求中的異常；7. 第三方包如 sentry 提供更強大監控功能；8. 記錄不同級別異常時，按嚴重程度選擇 debug 到 emergency 級別并附加上下文信息；9. api異常需返回json格式響應，檢查 $request->wantsjson() 以決定輸出形式；10. 避免過度捕獲異常，僅處理能解決的異常并將其他傳遞給高層處理程序，提升調試效率。
處理異常情況在laravel中至關重要，它能確保你的應用在遇到問題時不會崩潰，而是優雅地處理并提供有用的反饋。Laravel提供了一套強大的異常處理機制，讓你能夠集中化地管理和記錄應用中的異常。
解決方案
Laravel的異常處理核心在于app/Exceptions/Handler.php文件。這個類負責捕獲所有未捕獲的異常，并將其轉化為響應。你可以通過修改這個文件來自定義異常處理邏輯。
-
報告異常 (Reporting Exceptions):
report 方法用于記錄異常。默認情況下，Laravel會使用 config/Logging.php 中配置的日志通道來記錄異常。你可以根據需要選擇不同的日志驅動，例如 stack, single, daily, slack, papertrail, monolog, custom, syslog, Errorlog。
-
渲染異常 (Rendering Exceptions):
render 方法負責將異常轉換為HTTP響應。默認情況下，Laravel會根據 APP_DEBUG 環境變量的值來顯示不同的錯誤頁面。在生產環境中，通常會顯示一個友好的錯誤頁面，而在開發環境中，則會顯示詳細的錯誤信息。
use IlluminateHttpRequest; use SymfonyComponentHttpFoundationResponse; public function render(Request $request, Throwable $exception) { // 自定義渲染邏輯 if ($exception instanceof CustomException) { return response()->view('errors.custom', ['message' => $exception->getMessage()], 500); } return parent::render($request, $exception); // 默認行為，顯示錯誤頁面 } -
自定義異常類型:
創建自定義異常類可以讓你更清晰地組織和處理特定類型的錯誤。
namespace AppExceptions; use Exception; class CustomException extends Exception { public function __construct(string $message = "A custom error occurred", int $code = 0, Throwable $previous = null) { parent::__construct($message, $code, $previous); } public function report() { Log::error('Custom Exception: ' . $this->getMessage()); } }然后，在代碼中使用 throw new CustomException(‘Something went wrong’); 拋出異常。
-
HTTP異常:
Laravel提供了一組預定義的HTTP異常類，例如 NotFoundHttpException, BadRequestHttpException, UnauthorizedHttpException 等。你可以使用 abort 輔助函數拋出這些異常。
abort(404, 'Resource not found.');
-
try-catch 塊:
使用 try-catch 塊可以捕獲特定代碼塊中可能發生的異常。
try { // 可能拋出異常的代碼 $result = someFunction(); } catch (CustomException $e) { // 處理 CustomException Log::error('Caught CustomException: ' . $e->getMessage()); return response()->view('errors.custom', ['message' => $e->getMessage()], 500); } catch (Exception $e) { // 處理其他異常 Log::error('Caught Exception: ' . $e->getMessage()); return response()->view('errors.generic', ['message' => 'An error occurred'], 500); } finally { // 無論是否發生異常都會執行的代碼 // 例如，關閉數據庫連接 } -
全局異常處理中間件:
你可以創建一個全局異常處理中間件，用于在所有請求中捕獲異常。這對于處理一些通用的異常情況非常有用，例如記錄請求信息或重定向用戶到錯誤頁面。
-
使用第三方包:
有很多第三方包可以幫助你更好地處理異常，例如 Sentry, Bugsnag, Raygun 等。這些包通常提供更強大的異常監控和報告功能。
如何記錄不同級別的異常信息？
Laravel的日志系統支持不同的日志級別，例如 debug, info, notice, warning, error, critical, alert, emergency。你可以根據異常的嚴重程度選擇合適的日志級別。
use IlluminateSupportFacadesLog; try { // 一些代碼 } catch (Exception $e) { if ($e instanceof SomeSpecificException) { Log::error('Specific error occurred: ' . $e->getMessage(), ['context' => $data]); } else { Log::warning('Unexpected error: ' . $e->getMessage(), ['context' => $data]); } }
注意 Log::error 和 Log::warning 的第二個參數，[‘context’ => $data]，允許你添加額外的上下文信息到日志中，方便調試。
如何優雅地處理API請求中的異常？
處理API請求中的異常與處理Web請求中的異常略有不同。對于API請求，通常需要返回JSON格式的錯誤響應，并包含適當的HTTP狀態碼。
use IlluminateHttpJsonResponse; use SymfonyComponentHttpKernelExceptionHttpException; public function render($request, Throwable $e) { if ($request->wantsJson()) { // API請求 if ($e instanceof HttpException) { $statusCode = $e->getStatusCode(); $message = $e->getMessage(); } else { $statusCode = 500; $message = 'Server error'; } return new JsonResponse([ 'error' => [ 'message' => $message, 'status_code' => $statusCode, ] ], $statusCode); } return parent::render($request, $e); }
在這個例子中，我們檢查請求是否需要JSON響應 ($request->wantsJson())。如果是，我們創建一個包含錯誤消息和狀態碼的JSON響應。對于 HttpException 實例，我們使用異常本身提供的狀態碼和消息。對于其他異常，我們使用500狀態碼和通用的“Server error”消息。
如何避免過度捕獲異常？
過度捕獲異?？赡軙谏w一些潛在的問題，并使代碼更難調試。應該只捕獲你能夠處理的異常，并將其他異常傳遞給更高級別的異常處理程序。
不要這樣寫：
try { // 大段代碼 } catch (Exception $e) { Log::error('Something went wrong: ' . $e->getMessage()); // 僅僅記錄日志，沒有做任何處理 }
更好的做法是：
try { // 可能拋出特定異常的代碼 $user = User::findOrFail($id); } catch (ModelNotFoundException $e) { // 處理用戶未找到的情況 abort(404, 'User not found'); } catch (Exception $e) { // 處理其他異常，例如數據庫連接錯誤 Log::critical('Unexpected error: ' . $e->getMessage()); return response()->view('errors.500', [], 500); }
只捕獲 ModelNotFoundException，因為你知道如何處理它（返回404錯誤）。其他異常（例如數據庫連接錯誤）應該由更高級別的異常處理程序處理。Log::critical 用于記錄那些你預期之外的，需要立即關注的錯誤。
