当前位置：首页 > news >正文

【Express.js】异常分类和日志分级

news 2025/7/22 17:45:33

异常分类和日志分级

第一章已经介绍过全局的异常处理了，但之前的做法过于简单，一股脑的捕获并返回。这一节我们将对异常进行细致的分类，并且日志也做标准化的分级。

准备工作

一个基础的 evp-express 项目

NodeJS Error

先了解一下 NodeJS 里面的异常：

JavaScript 异常是由于无效操作或作为 throw 语句的目标而抛出的值。虽然不要求这些值是 Error 的实例或从 Error 继承的类，但 Node.js 或 JavaScript 运行时抛出的所有异常都将是 Error 的实例。

在 NodeJS 中，所有抛出（throw）的异常都可以被归为通用的 Error，此外还内置了更细分的 AssertionError, SystemError, SyntaxError 等。

Error：

new Error(message[, options])
error.cause：引起 error 的根本原因，可以在 new 时的options中加入
error.message：错误的描述
error.stack：错误栈，产生 error 的位置

异常分类

evp-express 的错误中间件已经把异常分类做好了，分成两部分 excather 和 exlogger，excatcher 捕获并处理异常，exlogger 则记录日志。我们先来看怎么对异常自定义分类。

自定义分类

自定义分类的方法，其实很简单，无非是在抛出的异常上增加用以标识分类的属性即可。我没有选择这种方式，手动抛出时要略微多写几行代码，error.message 是一个描述字符串，我选择抛出自定义异常时，传递的message是一个json字符串，json里面再放置具体描述，分类信息以及其它等等的信息载体。

throw new Error(JSON.stringfy(code: 400,msg: "自定义异常1",back: true
));

接下来看看异常处理器如何处理自定义异常和其它异常。

excatcher

excatcher做了三件事，捕获异常，解析异常和根据策略调取异常处理器。

解析异常：首先尝试将 err.message 作为 json 字符串解析，如果能解析，说明是我们自定义的异常，如果解析失败，说明是其它的异常，就当作普通的 Error 处理。
处理自定义异常：自定义异常的载体我总共设置了6个属性：code（分类码），msg（描述信息），symbol（业务码/异常码），data（数据），back（是否返回给前端具体描述）和 status（http状态码）。back置非，就返回通用的系统异常错误给前端；back置是，则根据 code（分类码）从异常处理策略中取出对应的处理器处理结果，如果找不到对应的处理器或者 code 没传，就还是返回统一的系统异常给前端。处理完异常之后，把异常再传递给 exlogger 中间件，去记录异常的日志。
异常处理策略：在处理不同的异常上，使用了策略模式，增强代码的可维护性。

excatcher: (err, req, res, next) => {if (err) {try {const payload = JSON.parse(err.message);const {code,msg,symbol,data,back,status} = payload;if (back != false) {const handler = exhandleStrategy.get(code);if ( handler ) { handler(res,msg,symbol,data,status); }else { res.json(Resp.bad("System Exception")); }} else {res.json(Resp.bad("System Exception"));}} catch (_) { // cannot be parsed to JSON object => common errorres.json(Resp.bad("System Exception"));}next(err);} else {next();}
},

exhandleStrategy：

const exhandleStrategy = new Map();exhandleStrategy.set(400, (res, ...args)=>{const [msg,symbol,data,status] = args;if (status) {res.status(status).json(Resp.fail(msg, symbol??-1, data??null));} else {res.json(Resp.fail(msg, symbol??-1, data??null));}
});exhandleStrategy.set(500, (res, ...args)=>{const [msg,symbol,data,status] = args;if (status) {res.status(status).json(Resp.bad(msg));} else {res.json(Resp.bad(msg));}
})

接下来我们看看 exlogger

exlogger

exlogger 进行了一个判断，如果当前日志级别 <= 10000，即 DEBUG，就记录完整的异常信息，否则只记录异常的描述信息。

exlogger: (err,req,res,next)=>{if (logger.level.level <= 10000) {logger.error(err);return;}logger.error(err.message);
}

logger是什么呢？这是 log4js 的日志器，让我们来看看utils/logger.js

log4js标准化日志

我们使用 log4js.js 作为日志框架，log4js.configure 配置了 log4js 的基本配置，日志格式，日志方式（输出、文件等）、日志级别等，日志级别从 evp-express 的项目配置信息中读取而得。

const config = require('../config').get();
const log4js = require('log4js');let logger = log4js.getLogger("");log4js.configure({appenders: {out: {type: "stdout",layout: {"type": "pattern","pattern": "[%d{yyyy-MM-dd hh:mm:ss}] %p %m"}}},categories: {default: {appenders: ["out"],level: config.log4js.level}}
})module.exports = logger;

日志级别总共有 “ALL”，“TRACE”, “DEBUG”, “INFO”, “WARN”, “ERROR”, “FATAL”（致命）, “MARK”, “OFF”（关闭）这几级（大小写均支持），重要性逐级递增，在当前设置的 level 之下的日志将不会被记录，如日志级别设置为 “INFO”，则 logger.all, logger.trace, logger.debug 将不会进行日志记录。