構(gòu)建 Web 應(yīng)用程序時，事情并不總是按計劃進(jìn)行。用戶可能會嘗試無效的操作，數(shù)據(jù)可能會丟失，或者可能會出現(xiàn)意外的錯誤。優(yōu)雅地處理這些錯誤對于創(chuàng)建可靠的應(yīng)用程序和提供良好的用戶體驗至關(guān)重要。

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

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

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

這就是自定義錯誤類派上用場的地方！
創(chuàng)建自定義錯誤類

這是一個名為 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
    }
}

它是如何工作的？

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

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

現(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 的實例，則將其視為操作錯誤。這些是您預(yù)期的錯誤（例如，驗證問題或缺少資源）。
如果不是 AppError，則將其視為意外錯誤。這些可能是您的代碼中的錯誤或您沒有計劃的事情。

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)用程序中有一條路線，用戶可以在其中提交表單，但缺少某些字段。您可以像這樣使用 AppError 類：

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ù)。
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." }
    ]
}

為什么使用這種模式？

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

結(jié)論
錯誤處理不必很復(fù)雜！通過使用自定義錯誤類和中間件，您可以構(gòu)建一個強(qiáng)大且適合初學(xué)者的系統(tǒng)，使您的應(yīng)用程序可靠并讓用戶滿意。

您對這種做法有何看法？對于處理 Node.js 中的錯誤，您有什么技巧或竅門嗎？請在下面的評論中告訴我！

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