你的 Express 应用还在裸奔?赶紧加上这层错误处理的保护罩!

一、错误处理的核心机制

Express通过四参数中间件构建错误处理流水线,需特别注意:

javascript 复制代码
// 错误中间件标准结构
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({error: err.message || '服务器内部错误'  });
});

执行顺序原则 :必须定义在所有常规中间件和路由之后

错误传递机制 :通过next(err)触发错误处理链

响应灵活性:支持HTML、JSON、纯文本等多种响应格式

开发陷阱 :忘记调用next(err)会导致错误未被捕获,引发进程崩溃

二、同步与异步错误的差异化处理

  1. 同步错误自动捕获

    javascript 复制代码
    app.get('/sync', (req, res) => {
      throw new Error('同步错误示例'); // Express自动捕获
    });
  2. 异步错误必须显式传递

    javascript 复制代码
    // 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);
      });
    });

三、错误处理架构设计(防御体系)

  1. 日志记录层

    javascript 复制代码
    function logErrors(err, req, res, next) {
      console.error(`${Date.now()}|${req.ip}|${err.stack}`);
      next(err); // 传递给下一层
    }
  2. 客户端错误层

    javascript 复制代码
    function clientErrorHandler(err, req, res, next) {
      if (req.xhr) {
        res.status(500).json({code: 'API_ERR'}); // AJAX请求专用响应
      } else {
        next(err);
      }
    }
  3. 终极兜底层

    javascript 复制代码
    app.use((err, req, res, next) => {
      if (res.headersSent) {
        return next(err); // 交还Express默认处理
      }
      res.status(500).send('系统开小差了,工程师正在抢修!');
    });
  4. 未匹配路由处理

    javascript 复制代码
    app.use('*', (req, res) => {
      res.status(404).sendFile('./public/404.html'); // 统一404页面
    });
相关推荐
Winson℡27 分钟前
React Native 中的 useCallback
javascript·react native·react.js
学编程的小鬼1 小时前
SpringBoot 自动装配原理剖析
java·spring boot·后端
码事漫谈1 小时前
SIMD编程入门:让性能飞起来的实践指南
后端
码事漫谈1 小时前
从汇编角度看C++优化:编译器真正做了什么
后端
老葱头蒸鸡3 小时前
(28)ASP.NET Core8.0 SOLID原则
后端·asp.net
谢尔登3 小时前
【Nest】基本概念
javascript·node.js·express
EveryPossible3 小时前
带有渐变光晕
前端·javascript·css
拾忆,想起4 小时前
AMQP协议深度解析:消息队列背后的通信魔法
java·开发语言·spring boot·后端·spring cloud
jojo是只猫4 小时前
Vue 3 开发的 HLS 视频流播放组件+异常处理
前端·javascript·vue.js
PH = 74 小时前
Spring Ai Alibaba开发指南
java·后端·spring