如何在Validation Handler中访问ConflictError对象以返回正确错误信息

我在自定义字段验证规则时抛出了ConflictError，但当前的验证处理器只能提取错误消息，没法直接拿到ConflictError实例，也就没法用它的自定义属性（比如状态码）返回精准的错误响应。

我的自定义验证代码：

.custom(async (username) => {
    const user = await UserModel.findOne({ username })
    if (user) throw new ConflictError('username already used')
    return true
}),

我的验证处理器代码：

const validatePayload = (): RequestHandler => {
    return (req, res, next) => {
        const result = validationResult(req)
        if (result.isEmpty()) return next()

        const error = result.array()[0]
        const msg = `${error.msg} at ${error.param}`
        throw new ValidationError(msg)
    }
}

解决方案 #

要在验证处理器里拿到ConflictError实例，得调整验证规则的错误传递逻辑，让验证结果能保留原始错误对象，再修改处理器提取这个对象。

1. 修改自定义验证规则，传递原始错误 #

如果用的是class-validator，直接抛出自定义错误后，验证结果里的错误项会包含originalError字段，也可以手动把错误挂载到req对象上做兜底：

.custom(async (username, { req }) => {
    const user = await UserModel.findOne({ username })
    if (user) {
        const conflictErr = new ConflictError('username already used')
        // 把自定义错误挂载到req上，方便后续获取
        req.customValidationError = conflictErr
        throw conflictErr
    }
    return true
}),

2. 更新验证处理器，提取自定义错误 #

修改validatePayload，优先读取挂载的自定义错误，或者从验证结果的原始错误字段里取：

const validatePayload = (): RequestHandler => {
    return (req, res, next) => {
        const result = validationResult(req)
        if (result.isEmpty()) return next()

        // 先检查req上有没有我们挂载的自定义错误
        if (req.customValidationError) {
            throw req.customValidationError
        }

        // 再尝试从验证结果的错误项里拿原始错误
        const firstError = result.array()[0]
        if (firstError.originalError instanceof ConflictError) {
            throw firstError.originalError
        }

        // 没有自定义错误的情况，抛出普通验证错误
        const msg = `${firstError.msg} at ${firstError.param}`
        throw new ValidationError(msg)
    }
}

3. 确保自定义错误类的类型判断有效 #

你的ConflictError必须正确继承Error，否则instanceof判断会失效，还可以添加自定义的状态码属性：

class ConflictError extends Error {
    statusCode: number

    constructor(message: string) {
        super(message)
        this.name = 'ConflictError'
        // 修复原型链，保证instanceof正常工作
        Object.setPrototypeOf(this, ConflictError.prototype)
        // 自定义状态码，对应HTTP 409冲突
        this.statusCode = 409
    }
}

4. 全局错误处理中间件（可选） #

最后在全局错误处理里，可以根据错误类型返回对应的状态码和消息：

app.use((err, req, res, next) => {
    if (err instanceof ConflictError) {
        return res.status(err.statusCode).json({ message: err.message })
    }
    if (err instanceof ValidationError) {
        return res.status(400).json({ message: err.message })
    }
    res.status(500).json({ message: '服务器内部错误' })
})

内容的提问来源于stack exchange，提问作者me noob