章
目
录
如果Express应用忽视错误处理，就如同在“裸奔”，极易受到各种错误的冲击。接下来，咱们就深入探讨一下Express应用中的错误处理机制，教你如何给应用加上一层坚固的“保护罩”。
一、Express错误处理的核心原理
Express通过四参数中间件构建起错误处理的“流水线”，理解这一机制的关键要素十分重要。
// 错误中间件标准结构
app.use((err, req, res, next) => {
console.error(err.stack);
res.status(500).json({error: err.message || '服务器内部错误' });
});
上述代码展示了错误中间件的标准结构。在这个结构中：
- 执行顺序原则：这类错误处理中间件必须定义在所有常规中间件和路由之后。这就好比工厂的质检环节，要在所有生产工序完成后进行，才能全面检查出产品（请求处理）过程中出现的问题。
- 错误传递机制：通过
next(err)来触发错误处理链。当某个环节出现错误时，就像传递接力棒一样，把错误传递给后续的错误处理中间件。 - 响应灵活性：它支持多种响应格式，比如HTML、JSON、纯文本等。这样可以根据不同的场景和需求，向客户端返回合适的错误信息。
这里有个容易踩的开发陷阱：要是忘记调用next(err)，错误就像丢失的信件，无法被捕获处理，严重时甚至会导致应用进程崩溃。
二、同步与异步错误的处理差异
在Express应用中，同步错误和异步错误的处理方式有所不同。
（一）同步错误自动捕获
app.get('/sync', (req, res) => {
throw new Error('同步错误示例'); // Express自动捕获
});
在这段代码里，当抛出同步错误时，Express会自动捕获这个错误，并按照既定的错误处理流程去处理。
（二）异步错误必须显式传递
// Promise方案
app.get('/async', async (req, res, next) => {
Promise.reject(new Error('异步错误示例'))
.catch(next); // Correctly pass 'next' without calling it immediately,必须手动调用next方法
});
// Callback方案
app.get('/callback', (req, res, next) => {
fs.readFile('missing.txt', (err, data) => {
if (err) return next(err); // 错误传递关键
res.send(data);
});
});
对于异步操作，需要开发者手动去掌控。在Promise方案中，通过.catch(next)将错误传递给错误处理中间件；在Callback方案里，当读取文件出错时，用next(err)把错误传递出去，这样才能让错误得到正确处理。
三、构建完善的错误处理架构（防御体系）
为了让应用能够更好地应对各种错误，我们可以设计一套多层次的错误处理架构。
（一）日志记录层
function logErrors(err, req, res, next) {
console.error(`${Date.now()}|${req.ip}|${err.stack}`);
next(err); // 传递给下一层
}
logErrors函数将错误发生的时间、请求的IP地址以及错误堆栈信息记录下来，方便开发者事后排查问题。记录完后，再把错误传递给下一层处理。
（二）客户端错误层
function clientErrorHandler(err, req, res, next) {
if (req.xhr) {
res.status(500).json({code: 'API_ERR'}); // AJAX请求专用响应
} else {
next(err);
}
}
客户端错误层主要针对不同类型的请求做出差异化处理。如果是AJAX请求（通过req.xhr判断），就返回一个JSON格式的错误响应；如果不是，就把错误继续传递下去。
（三）终极兜底层
app.use((err, req, res, next) => {
if (res.headersSent) {
return next(err); // 交还Express默认处理
}
res.status(500).send('系统开小差了，工程师正在抢修！');
});
终极兜底层是错误处理的最后一道防线。当其他处理层都无法处理错误，或者响应头已经发送时，这一层就会发挥作用。它会返回一个通用的错误提示给用户，同时把错误交还给Express默认处理机制。
（四）未匹配路由处理
app.use('*', (req, res) => {
res.status(404).sendFile('./public/404.html'); // 统一404页面
});
当请求的路由在应用中找不到匹配项时，这部分代码就会被触发。它会返回一个统一的404页面，让用户知道请求的页面不存在。
通过以上对Express应用错误处理的全面介绍，希望大家能重视并构建起完善的错误处理体系，这样Express应用才能更加健壮、稳定。
