Express 项目环境搭建 -- 7. 错误处理中间件

在开发过程中，我们会遇到各种不符合要求的请求，需要将这种请求拦截下来，并告知请求方明确的错误信息，且要保证程序在运行过程中不会被未知的错误导致崩溃，错误错误处理就尤为重要了。

定义准确的错误信息

我们可以创建一个文件来定义一系列错误信息，在需要的时候只要传入错误码（甚至一些自定义的错误信息），就能得到想要错误信息结构，方便返回，而不再需要每次都构建一次

// utils/errcode.js
const ERRCODE = {
	0: {
		status: 200,
		body: {
			errcode: "0",
			errmsg: "ok"
		}
	},
	40001: {
		status: 400,
		body: {
			errcode: "40001",
			errmsg: "参数错误"
		}
	},
	40002: {
		status: 400,
		body: {
			errcode: "40002",
			errmsg: "无权访问"
		}
	},
	40003: {
		status: 400,
		body: {
			errcode: "40003",
			errmsg: "无效 token"
		}
	},
	40004: {
		status: 400,
		body: {
			errcode: "40004",
			errmsg: "请求太频繁，请稍后重试"
		}
	},
	50000: {
		status: 500,
		body: {
			errcode: "50000",
			errmsg: "服务端错误"
		}
	}
};

function errcode(code, res = {}) {
	return {
		...(ERRCODE[code] || ERRCODE[50000]),
		body: {
			...(ERRCODE[code] || ERRCODE[50000]).body, ...res
		}
	};
}

module.exports = errcode;

errcode 对错误的错误码，在文件中查找对应的对象，并封装成下面这种格式：

{
  "status": 200,
  "body": {
    "errcode": "0",
    "errmsg": "ok"
    ...
  }
}

调用者就能得到统一的返回数据。

拦截请求并抛出错误信息

为了能自定义错误，还需要对 Error 对象重新处理

  // utils/MyError.js
function MyError(errcode = 50000, message = { }) {
	this.name = "MyError";
	this.errcode = errcode;
	this.resBody = message;
	this.stack = (new Error()).stack;
}
MyError.prototype = Object.create(Error.prototype);
MyError.prototype.constructor = MyError;
// global.MyError = MyError;
module.exports = MyError;

使用自定义错误对象抛出错误

const express = require("express");
const router = express.Router();
const { MyError } = require("../../../utils/index");

router.post("", async function(req, res, next) {
	try {
        // ...
		throw new MyError(40001, {data:{}});
    } catch(err) {
        next(err);
    }
});

兜底所有因请求问题导致的错误

const express = require("express");
// require("./utils/MyError");

// 文件最后调用
app.use(function ErrorHandler(err, req, res, next) {
	const error = errcode(err.errcode);
	console.log(err);
	res.status(error.status).send({ ...error.body, ...(err.name === "MyError" ? err.resBody : {}) });
});