Node.js中使用Joi验证时如何返回自定义HTTP错误码？

Joi的any.error()方法允许你返回自定义的Error实例，你可以给这个实例手动添加status属性来存储自定义HTTP状态码——原生Error对象本身没有这个属性，但我们可以直接扩展它。

基础实现示例 #

直接在返回的Error实例上添加status字段：

const schema = Joi.object({
    foo: Joi.number().min(0).error((errors) => {
        // 结合错误信息生成自定义提示
        const err = new Error(`"foo"必须是正数，当前输入：${errors[0].value}`);
        // 设置自定义HTTP状态码，比如400（Bad Request）
        err.status = 400;
        return err;
    })
});

在请求处理中使用 #

以Express框架为例，校验后捕获错误并返回对应状态码：

app.post('/validate', (req, res) => {
    const { error } = schema.validate(req.body);
    if (error) {
        // 优先用自定义状态码，默认 fallback 到500
        return res.status(error.status || 500).json({
            message: error.message
        });
    }
    // 校验通过后的业务逻辑
    res.json({ success: true });
});

针对不同错误类型设置不同状态码 #

如果需要根据具体校验失败类型返回不同状态码，可以在error回调里遍历错误数组，判断错误类型：

const schema = Joi.object({
    foo: Joi.number().min(0).error((errors) => {
        let errMsg = '';
        let statusCode = 400;

        errors.forEach(err => {
            switch (err.type) {
                case 'number.min':
                    errMsg = `"foo"不能小于${err.context.limit}`;
                    break;
                case 'number.base':
                    errMsg = `"foo"必须是数字类型`;
                    statusCode = 422; // Unprocessable Entity
                    break;
                default:
                    errMsg = '参数校验失败';
            }
        });

        const err = new Error(errMsg);
        err.status = statusCode;
        return err;
    })
});

内容的提问来源于stack exchange，提问作者Kevin Bryan