錯誤處理是軟體開發的重要方面，可確保應用程式的行為可預測，並在出現問題時提供有意義的回饋。在 Node.js 中，由於其非同步特性，有效的錯誤處理可能特別具有挑戰性。本文深入探討了管理 Node.js 應用程式中的錯誤的先進技術和最佳實踐。
了解錯誤類型
在深入研究錯誤處理策略之前，了解可能遇到的錯誤類型非常重要：
- 同步錯誤：
同步程式碼執行期間發生的錯誤可以使用 try-catch 區塊擷取。
- 非同步錯誤：
錯誤發生在非同步程式碼執行期間，例如回呼、promise 和 async/await 函數。
- 操作錯誤：
表示程式需要處理的執行時間問題（例如，無法連線到資料庫）的錯誤。
- 程式設計師錯誤：
程式中的錯誤（例如，型別錯誤、斷言失敗）。通常不應以與操作錯誤相同的方式捕獲和處理這些錯誤。
同步錯誤處理
對於同步程式碼，錯誤處理使用 try-catch 區塊：
try {
// Synchronous code that might throw an error
let result = dafaultFunction();
} catch (error) {
console.error('An error occurred:', error.message);
// Handle the error appropriately
}非同步錯誤處理
- callback
在基於回調的非同步程式碼中，錯誤通常是回呼函數中的第一個參數：
const fs = require('fs');
fs.readFile('/path/to/file', (err, data) => {
if (err) {
console.error('An error occurred:', err.message);
// Handle the error
return;
}
// Process the data
});- promise
Promise 提供了一種更簡潔的方法來使用 .catch() 處理非同步錯誤：
const fs = require('fs').promises;
fs.readFile('/path/to/file')
.then(data => {
// Process the data
})
.catch(err => {
console.error('An error occurred:', err.message);
// Handle the error
});- async/await
Async/await 語法允許在非同步程式碼中進行更同步的錯誤處理：
const fs = require('fs').promises;
async function readFile() {
try {
const data = await fs.readFile('/path/to/file');
// Process the data
} catch (err) {
console.error('An error occurred:', err.message);
// Handle the error
}
}
readFile();集中錯誤處理
對於較大的應用程式，集中錯誤處理可以幫助更有效地管理錯誤。這通常涉及 Express.js 應用程式中的中間件。
- Express.js 中介軟體
Express.js 提供了一種透過中間件處理錯誤的機制。這個中間件應該是堆疊中的最後一個：
const express = require('express');
const app = express();
// Define routes and other middleware
app.get('/', (req, res) => {
throw new Error('Something went wrong!');
});
// Error-handling middleware
app.use((err, req, res, next) => {
console.error(err.stack);
res.status(500).json({ message: 'Internal Server Error' });
});
app.listen(3000, () => {
console.log('Server is running on port 3000');
});先進技術
- 自訂錯誤類別
建立自訂錯誤類別可以幫助區分不同類型的錯誤並使錯誤處理更加精細：
class AppError extends Error {
constructor(message, statusCode) {
super(message);
this.statusCode = statusCode;
Error.captureStackTrace(this, this.constructor);
}
}
// Usage
try {
throw new AppError('Custom error message', 400);
} catch (error) {
if (error instanceof AppError) {
console.error(`AppError: ${error.message} (status: ${error.statusCode})`);
} else {
console.error('An unexpected error occurred:', error);
}
}- 錯誤記錄
實施強大的錯誤日誌記錄以監視和診斷問題。 Winston 或 Bunyan 等工具可以幫助記錄日誌：
const winston = require('winston');
const logger = winston.createLogger({
level: 'error',
format: winston.format.json(),
transports: [
new winston.transports.File({ filename: 'error.log' })
]
});
// Usage
try {
// Code that might throw an error
throw new Error('Something went wrong');
} catch (error) {
logger.error(error.message, { stack: error.stack });
}- 全域錯誤處理
處理未捕獲的異常和未處理的承諾拒絕可確保不會漏掉任何錯誤：
process.on('uncaughtException', (error) => {
console.error('Uncaught Exception:', error);
// Perform cleanup and exit process if necessary
});
process.on('unhandledRejection', (reason, promise) => {
console.error('Unhandled Rejection at:', promise, 'reason:', reason);
// Perform cleanup and exit process if necessary
});最佳實踐
-
快速失敗：儘早偵測並處理錯誤。
-
正常關閉：確保您的應用程式在發生嚴重錯誤時可以正常關閉。
-
有意義的錯誤訊息：提供清晰且可操作的錯誤訊息。
-
避免靜默故障：始終記錄或處理錯誤以避免靜默故障。
-
測試錯誤場景：編寫測試來覆蓋潛在的錯誤場景並確保錯誤處理按預期工作。
結論
為了有效地處理 Node.js 中的錯誤，您需要結合使用同步和非同步技術、集中管理以及進階策略，例如自訂錯誤類別和強大的日誌記錄。透過結合這些最佳實踐和先進技術，您可以建立強大的 Node.js 應用程式，優雅地處理錯誤並為用戶提供改進的體驗。
原文出處：https://dev.to/amritak27/advanced-error-handling-in-nodejs-1ep8
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式