Node.js中出现未捕获异常的处理方法


Posted in Javascript onJune 29, 2020

前言

Node.js 程序运行在单进程上,应用开发时一个难免遇到的问题就是异常处理,对于一些未捕获的异常处理起来,也不是一件容易的事情。

未捕获异常的程序

下面展示了一段简单的应用程序,如下所示:

const http = require('http');
const PORT = 3000;
const server = http.createServer((req, res) => {
 if (req.url === '/error') {
  a.b;
  res.end('error');
 } else {
  setTimeout(() => res.end('ok!'), 1000 * 10);
 }
});

 
server.listen(PORT, () => console.log(`port is listening on ${PORT}.`));

运行以上程序,在右侧第二个窗口中执行了 /error 路由,因为没有定义 a 这个对象,则会引发错误。

Node.js中出现未捕获异常的处理方法

进程崩溃退出之后导致整个应用程序也将崩溃,左侧是一个延迟的响应,也将无法正常工作。

这是一个头疼的问题,不要紧,下文我们将会学到一个优雅退出的方案。

进程崩溃优雅退出

关于错误捕获,Node.js 官网曾提供了一个模块 domain 来实现,但是现在已废弃了所以就不再考虑了。

之前在看 CNPM 这个项目时看到了以下关于错误退出的一段代码:

// https://github.com/cnpm/cnpmjs.org/blob/master/worker.js#L18
graceful({
 server: [registry, web],
 error: function (err, throwErrorCount) {
  if (err.message) {
   err.message += ' (uncaughtException throw ' + throwErrorCount + ' times on pid:' + process.pid + ')';
  }
  console.error(err);
  console.error(err.stack);
  logger.error(err);
 }
});

上述使用的是 graceful 这个模块,在 NPM 上可以找到。

实现一个 graceful.js

实现一个 graceful 函数,初始化加载时注册 uncaughtException、unhandledRejection 两个错误事件,分别监听未捕获的错误信息和未捕获的 Promise 错误信息。

const http = require('http');

/**
 * graceful
 * @param { Number } options.killTimeout 超时时间
 * @param { Function } options.onError 产生错误信息会执行该回调函数
 * @param { Array } options.servers Http Server
 * @returns
 */
function graceful(options = {}) {
 options.killTimeout = options.killTimeout || 1000 * 30;
 options.onError = options.onError || function () {};
 options.servers= options.servers || [];
 process.on('uncaughtException', error => handleUncaughtException(error, options));
 process.on('unhandledRejection', error => handleUnhandledRejection(error, options));
}

handleUncaughtException、handleUnhandledRejection 分别接收相应的错误事件,执行应用传入的 onError() 将错误信息进行回传,最后调用 handleError()。

const throwCount = {
 uncaughtException: 0,
 unhandledRejection: 0
};
function handleUncaughtException(error, options) {
 throwCount.uncaughtException += 1;
 options.onError(error, 'uncaughtException', throwCount.uncaughtException);

 if (throwCount.uncaughtException > 1) return;
 handleError(options);
};

function handleUnhandledRejection(error, options) {
 throwCount.unhandledRejection += 1;
 options.onError(error, 'unhandledRejection', throwCount.unhandledRejection);

 if (throwCount.unhandledRejection > 1) return;
 handleError(options);
}

HandleError 方法为核心实现,首先遍历应用传入的 servers,监听 request 事件,在未捕获错误触发之后,如果还有请求链接,则关闭当前请求的链接。

之后,执行 setTimeout 延迟退出,也就是最大可能的等待之前链接处理完成。

function handleError(options) {
 const { servers, killTimeout } = options;
 // 关闭当前请求的链接
 for (const server of servers) {
  console.log('server instanceof http.Server: ', server instanceof http.Server);
  if (server instanceof http.Server) {
   server.on('request', (req, res) => {
    req.shouldKeepAlive = false;
    res.shouldKeepAlive = false;
    if (!res._header) {
     res.setHeader('Connection', 'close');
    }
   });
  }
 }

 // 延迟退出
 const timer = setTimeout(() => {
  process.exit(1);
 }, killTimeout);
 
 if (timer && timer.unref) {
  timer.unref();
 }
}
module.exports = graceful;

应用程序中使用上述实现

加载上述 graceful.js 使用起来很简单只需要在文件尾部,加载 graceful 函数并传入相应参数即可。

const graceful = require('./graceful.js');
...
server.listen(PORT, () => console.log(`port is listening on ${PORT}.`));

graceful({
 servers: [server],
 onError: (error, type, throwErrorCount) => {
  console.log('[%s] [pid: %s] [throwErrorCount: %s] %s: %s', new Date(), process.pid, throwErrorCount, type, error.stack || error);
 }
});

再次运行应用程序,看看效果:

Node.js中出现未捕获异常的处理方法

这一次,即使右侧 /error 路由产生未捕获异常,也将不会引起左侧请求无法正常响应。

Graceful 模块

最后推荐一个 NPM 模块 graceful,引用文档中的一句话:“It's the best way to handle uncaughtException on current situations.”

该模块还提供了对于 Node.js 中 Cluster 模块的支持。

安装

$ npm install graceful -S

应用

如果一个进程中有多个 Server,将它们添加到 servers 中即可。

const graceful = require('graceful');
...

graceful({
 servers: [server1, server2, restapi],
 killTimeout: '15s',
});

总结

如果你正在使用 Node.js 对于异常你需要有些了解,上述讲解的两个异常事件可以做为你的最后补救措施,但是不应该当作 On Error Resume Next(出了错误就恢复让它继续)的等价机制。

到此这篇关于Node.js中出现未捕获异常处理方法的文章就介绍到这了,更多相关Node.js未捕获异常内容请搜索三水点靠木以前的文章或继续浏览下面的相关文章希望大家以后多多支持三水点靠木!

Reference

  • nodejs.cn/api/process.html
  • www.npmjs.com/package/graceful
Javascript 相关文章推荐
JavaScript实现自动弹出窗口并自动关闭窗口的方法
Aug 06 Javascript
前端性能优化及技巧
May 06 Javascript
jQuery validate验证插件使用详解
May 11 Javascript
jQuery实现页面评论栏中访客信息自动填写功能的方法
May 23 Javascript
JS实现图片的不间断连续滚动的简单实例
Jun 03 Javascript
JS闭包可被利用的常见场景小结
Apr 09 Javascript
[js高手之路]HTML标签解释成DOM节点的实现方法
Aug 31 Javascript
electron demo项目npm install安装失败的解决方法
Feb 06 Javascript
JsChart组件使用详解
Mar 04 Javascript
微信小程序模板template简单用法示例
Dec 04 Javascript
jQuery实现的中英文切换功能示例
Jan 11 jQuery
Node.js Domain 模块实例详解
Mar 18 Javascript
在Vue中使用antv的示例代码
Jun 29 #Javascript
vue实现一个6个输入框的验证码输入组件功能的实例代码
Jun 29 #Javascript
纯JS开发baguetteBox.js响应式画廊插件
Jun 28 #Javascript
JavaScript图片旋转效果实现方法详解
Jun 28 #Javascript
javascript+css实现俄罗斯方块小游戏
Jun 28 #Javascript
详解小程序横屏方案对比
Jun 28 #Javascript
微信小程序实现上传多张图片、删除图片
Jul 29 #Javascript
You might like
在PHP3中实现SESSION的功能(一)
2006/10/09 PHP
destoon实现不同会员组公司名称显示不同的颜色的方法
2014/08/22 PHP
php编写批量生成不重复的卡号密码代码
2015/05/14 PHP
php网页版聊天软件实现代码
2016/08/12 PHP
js模拟select下拉菜单控件的代码
2013/05/08 Javascript
JSON序列化与解析原生JS方法且IE6和chrome测试通过
2013/09/05 Javascript
jQuery中队列queue()函数的实例教程
2016/05/03 Javascript
AngularJS基础 ng-dblclick 指令用法
2016/08/01 Javascript
AngularJS表单验证中级篇(3)
2016/09/28 Javascript
超简单的Vue.js环境搭建教程
2017/03/17 Javascript
微信小程序获取用户openId的实现方法
2017/05/23 Javascript
checkbox:click事件触发span元素内容改变的方法
2017/09/11 Javascript
基于匀速运动的实例讲解(侧边栏,淡入淡出)
2017/10/17 Javascript
关于HTTP传输中gzip压缩的秘密探索分析
2018/01/12 Javascript
js实现每日签到功能
2018/11/29 Javascript
Vue项目页面跳转时浏览器窗口上方显示进度条功能
2020/03/26 Javascript
JavaScript实现无限轮播效果
2020/11/19 Javascript
Linux下通过python访问MySQL、Oracle、SQL Server数据库的方法
2016/04/23 Python
Python中字典的浅拷贝与深拷贝用法实例分析
2018/01/02 Python
Python实现对字典分别按键(key)和值(value)进行排序的方法分析
2018/12/19 Python
Python编程实现tail-n查看日志文件的方法
2019/07/08 Python
Python实现猜年龄游戏代码实例
2020/03/25 Python
解决Django部署设置Debug=False时xadmin后台管理系统样式丢失
2020/04/07 Python
Python参数传递对象的引用原理解析
2020/05/22 Python
Python常驻任务实现接收外界参数代码解析
2020/07/21 Python
Numpy数组的广播机制的实现
2020/11/03 Python
AmazeUI 单选框和多选框的实现示例
2020/08/18 HTML / CSS
Theflamel意大利:女士奢华服装、鞋子和配件
2020/01/11 全球购物
行政工作个人的自我评价
2014/02/13 职场文书
电子信息工程自荐信
2014/05/26 职场文书
销售员岗位职责
2014/06/09 职场文书
供应商食品安全承诺书
2015/04/29 职场文书
肖申克救赎观后感
2015/06/02 职场文书
朝花夕拾读书笔记
2015/06/29 职场文书
小学运动会加油稿
2015/07/22 职场文书
mysql5.7的安装及Navicate长久免费使用的实现过程
2021/11/17 MySQL