掌握 Express.js 中的高级错误处理以实现健壮的 Node.js 应用程序-js教程-PHP中文网

掌握 Express.js 中的高级错误处理以实现健壮的 Node.js 应用程序

Susan Sarandon

发布： 2024-12-07 19:04:20

原创

338 人浏览过

Mastering Advanced Error Handling in Express.js for Robust Node.js Applications

错误处理是开发健壮的 Express.js 应用程序的一个关键方面。无论是捕获未处理的异常、验证用户输入，还是妥善管理第三方 API 故障，经过深思熟虑的错误处理策略都可以节省您的调试时间并确保流畅的用户体验。在本博客中，我们将深入探讨 Express.js 中错误处理的高级技术，并以实际示例为支持。

为什么错误处理很重要
软件开发中错误是不可避免的，但优秀应用程序与优秀应用程序的区别在于它如何有效地管理这些错误。投资高级错误处理的主要原因包括：

改进的调试：快速识别问题的根本原因。
增强的用户体验：提供用户友好的错误消息。
安全性：防止在错误响应中暴露敏感数据。

设置集中式错误处理程序

集中式错误处理中间件简化了 Express.js 应用程序中的错误管理。

创建方法如下：

// errorHandler.js
const errorHandler = (err, req, res, next) => {
  console.error(err.stack);

  const statusCode = err.status || 500; // Default to 500 for unexpected errors
  const message = err.message || 'Internal Server Error';

  res.status(statusCode).json({
    success: false,
    message,
  });
};

module.exports = errorHandler;

登录后复制

在您的应用中的用法：

const express = require('express');
const errorHandler = require('./middleware/errorHandler');

const app = express();

// Your routes go here

app.use(errorHandler); // Centralized error handler
app.listen(3000, () => console.log('Server running on port 3000'));

登录后复制

使用中间件处理异步错误

使用辅助函数避免在异步路由处理程序中重复 try-catch 块：

const asyncHandler = (fn) => (req, res, next) =>
  Promise.resolve(fn(req, res, next)).catch(next);

登录后复制

用法示例：

app.get('/data', asyncHandler(async (req, res) => {
  const data = await fetchData(); // Assume this is an async function
  res.json({ success: true, data });
}));

登录后复制

此方法可确保 fetchData 中的任何错误都会自动传递到集中式错误处理程序。

Express.js 中流行的错误处理库：express-async-errors

express-async-errors 库是一个简单且广泛使用的解决方案，用于处理 Express.js 应用程序中异步代码中的错误。

安装：

npm install express-async-errors

登录后复制

用法：

require('express-async-errors'); // Import the library
const express = require('express');
const app = express();

app.get('/data', async (req, res) => {
  const data = await fetchData(); // If this fails, the error is handled automatically
  res.json({ success: true, data });
});

// Centralized error handler
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ success: false, message: 'Something went wrong!' });
});

app.listen(3000, () => console.log('Server running on port 3000'));

登录后复制

express-async-errors 库通过无缝处理异步函数中的错误来增强代码可读性并减少样板代码。

处理未捕获的错误

确保您的应用能够处理未处理的拒绝和未捕获的异常：

process.on('unhandledRejection', (reason, promise) => {
  console.error('Unhandled Rejection:', reason);
  // Add your cleanup logic here
  process.exit(1);
});

process.on('uncaughtException', (err) => {
  console.error('Uncaught Exception:', err);
  // Add your cleanup logic here
  process.exit(1);
});

登录后复制

库的验证错误

利用 Joi 等库进行输入验证并无缝集成错误处理：

Joi 示例：

const Joi = require('joi');

const validateUser = (req, res, next) => {
  const schema = Joi.object({
    name: Joi.string().min(3).required(),
    email: Joi.string().email().required(),
  });

  const { error } = schema.validate(req.body);
  if (error) {
    return next(new Error(error.details[0].message));
  }

  next();
};

app.post('/user', validateUser, (req, res) => {
  res.json({ success: true, message: 'User created successfully!' });
});

登录后复制

Express.js 中错误处理的最佳实践