建立 Web 應(yīng)用程式時，事情並不總是按計(jì)劃進(jìn)行。使用者可能會嘗試無效的操作，資料可能會遺失，或者可能會出現(xiàn)意外的錯誤。優(yōu)雅地處理這些錯誤對於創(chuàng)建可靠的應(yīng)用程式和提供良好的用戶體驗(yàn)至關(guān)重要。

在這篇文章中，我將向您展示如何在 Node.js 應(yīng)用程式中實(shí)作簡單而有效的錯誤處理系統(tǒng)。讓我們深入了解一下！ ？

錯誤處理的基礎(chǔ)知識

在 JavaScript 中，錯誤通常表示為 Error 類別的實(shí)例。當(dāng)出現(xiàn)問題時，您可以“拋出”錯誤，並且您的應(yīng)用程式可以捕獲它以做出相應(yīng)的回應(yīng)。然而，在較大的應(yīng)用程式中，僅使用基本 Error 類別來管理錯誤可能會變得混亂。

這就是自訂錯誤類別派上用場的地方！
建立自訂錯誤類別

這是一個名為 AppError 的類，我們可以用它來定義結(jié)構(gòu)化且有意義的錯誤：

export class AppError extends Error {
    constructor(name, httpCode, description, isOperational, errors = []) {
        super(description); // Call the parent class (Error) constructor
        this.name = name; // Name of the error (e.g., ValidationError)
        this.httpCode = httpCode; // HTTP status code (e.g., 400, 404, 500)
        this.isOperational = isOperational; // Flag to distinguish between operational and system errors
        this.errors = errors; // Optional array of detailed error messages
    }
}

它是如何運(yùn)作的？

• name：描述錯誤的類型，例如 ValidationError 或 NotFoundError。
• httpCode：設(shè)定適當(dāng)?shù)?HTTP 狀態(tài)碼，例如 400 表示錯誤請求，500 表示伺服器錯誤。
• 描述：提供描述錯誤的使用者友善訊息。
• isOperational：一個布林標(biāo)誌，指示錯誤是預(yù)期的（例如，使用者輸入問題）還是意外的（例如，錯誤）。
• 錯誤：可選列表，包含更多有關(guān)錯誤的具體詳細(xì)資訊（對於驗(yàn)證錯誤很有用）。

一個簡單的錯誤處理中間件

現(xiàn)在我們有了自訂錯誤類，我們需要一種方法來在我們的應(yīng)用程式中處理這些錯誤。輸入中間件：

export const errorHandler = (err, req, res, next) => {
    if (err instanceof AppError) {
        // Handle operational errors
        res.status(err.httpCode).json({
            success: false,
            error: err.name,
            message: err.message,
            errors: err.errors || [],
        });
    } else {
        // Handle unexpected errors
        console.error('Unexpected Error:', err.stack); // Log the stack trace for debugging
        res.status(500).json({
            success: false,
            error: 'InternalServerError',
            message: 'Something went wrong. Please try again later.',
        });
    }
};

這是做什麼的？
檢查錯誤類型：
如果錯誤是 AppError 的實(shí)例，則將其視為操作錯誤。這些是您預(yù)期的錯誤（例如，驗(yàn)證問題或缺少資源）。
如果不是 AppError，則將其視為意外錯誤。這些可能是您的程式碼中的錯誤或您沒有計(jì)劃的事情。

Responds with the right status code and message:
    For AppError instances, it sends a structured JSON response containing the error details.
    For unexpected errors, it sends a generic 500 response to the user and logs the details for debugging.

把它們放在一起

假設(shè)您的 Express 應(yīng)用程式中有一條路線，使用者可以在其中提交表單，但缺少某些欄位。您可以像這樣使用 A??ppError 類別：

app.post('/submit-form', (req, res, next) => {
    const { name, email } = req.body;

    if (!name || !email) {
        const errors = [];
        if (!name) errors.push({ field: 'name', message: 'Name is required.' });
        if (!email) errors.push({ field: 'email', message: 'Email is required.' });

        return next(new AppError('ValidationError', 400, 'Invalid input data.', true, errors));
    }

    res.json({ success: true, message: 'Form submitted successfully!' });
});

// Register the error-handling middleware
app.use(errorHandler);

出現(xiàn)錯誤時會發(fā)生什麼事？
如果姓名或電子郵件遺失，AppError 實(shí)例將傳遞到下一個函數(shù)。
errorHandler 中間件捕獲它並發(fā)送結(jié)構(gòu)化 JSON 回應(yīng)：

{
    "success": false,
    "error": "ValidationError",
    "message": "Invalid input data.",
    "errors": [
        { "field": "name", "message": "Name is required." },
        { "field": "email", "message": "Email is required." }
    ]
}

為什麼要用這種模式？

• 清晰度：自訂錯誤類別使您的錯誤更具描述性且更易於偵錯。
• 一致性：每個錯誤都遵循可預(yù)測的結(jié)構(gòu)，使前端開發(fā)人員更容易處理。
• 關(guān)注點(diǎn)分離：您的路由處理程序?qū)Ｗ㈧哆壿嫞虚g件則處理錯誤回應(yīng)。

結(jié)論
錯誤處理不必很複雜！透過使用自訂錯誤類別和中間件，您可以建立一個強(qiáng)大且適合初學(xué)者的系統(tǒng)，使您的應(yīng)用程式可靠並讓使用者滿意。

您對這種做法有何看法？對於處理 Node.js 中的錯誤，您有什麼技巧或訣竅嗎？請?jiān)谙旅娴脑u論中告訴我！

以上是在 Node.js 中建立簡單有效的錯誤處理系統(tǒng)的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！