Quarkus中REST接口参数验证异常的捕获与处理方法问询

Quarkus中没有专门命名为"ExceptionHandler"的组件，但可以通过**JAX-RS的ExceptionMapper**来捕获@Valid参数验证失败抛出的ConstraintViolationException，实现自定义的异常响应逻辑。

实现方式：自定义ExceptionMapper #

创建一个实现ExceptionMapper<ConstraintViolationException>的类，并添加@Provider注解，Quarkus会自动识别并使用它处理对应的异常：

import jakarta.validation.ConstraintViolation;
import jakarta.validation.ConstraintViolationException;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;
import java.util.stream.Collectors;

@Provider
public class ValidationExceptionMapper implements ExceptionMapper<ConstraintViolationException> {

    @Override
    public Response toResponse(ConstraintViolationException exception) {
        // 提取所有验证错误信息并拼接
        String errorDetails = exception.getConstraintViolations()
                .stream()
                .map(ConstraintViolation::getMessage)
                .collect(Collectors.joining("; "));

        // 返回400错误和自定义提示
        return Response.status(Response.Status.BAD_REQUEST)
                .entity("参数验证失败：" + errorDetails)
                .build();
    }
}

进阶：返回结构化错误信息 #

如果需要返回更规范的结构化错误（比如包含字段名和对应错误），可以定义一个错误DTO并转换响应内容：

1. 定义错误DTO：

public class ValidationError {
    private String field;
    private String message;

    // 构造器、Getter、Setter
    public ValidationError(String field, String message) {
        this.field = field;
        this.message = message;
    }

    // 省略Getter和Setter
}

2. 修改ExceptionMapper：

@Override
public Response toResponse(ConstraintViolationException exception) {
    var errors = exception.getConstraintViolations()
            .stream()
            .map(violation -> new ValidationError(
                    violation.getPropertyPath().toString(),
                    violation.getMessage()
            ))
            .collect(Collectors.toList());

    return Response.status(Response.Status.BAD_REQUEST)
            .entity(errors)
            .build();
}

注意事项 #

• 确保项目依赖中包含quarkus-hibernate-validator（如果已经使用@Valid注解，通常已经添加）。
• 自定义的ExceptionMapper会覆盖Quarkus默认的验证异常响应逻辑，让你完全控制返回的状态码和响应内容。

内容的提问来源于stack exchange，提问作者Andrej Flieger