Quarkus配置ServerExceptionMapper返回带自定义消息的HTTP 400错误

问题根源 #

你的自定义异常InvalidRowNumberException继承了BadRequestException，而Quarkus内置了针对BadRequestException（属于WebApplicationException子类）的异常映射器，其优先级高于你自定义的@ServerExceptionMapper，导致你的映射逻辑完全不生效。

解决方案 #

方案1：调整自定义异常父类（推荐） #

将自定义异常改为继承RuntimeException，避免被内置映射器拦截，让自定义映射器完全接管处理逻辑。

修改自定义异常类

public class InvalidRowNumberException extends RuntimeException {
    public InvalidRowNumberException(String message) {
        super(message);
    }
}

修改异常映射类

确保映射类使用@ServerExceptionMapper注解，且类为public：

@ServerExceptionMapper
public class InvalidRowNumberExceptionMapper {
    public RestResponse<String> map(InvalidRowNumberException e) {
        // 返回带自定义消息的400响应
        return RestResponse.status(RestResponse.Status.BAD_REQUEST, e.getMessage());
    }
}

方案2：覆盖内置BadRequestException映射（全局生效） #

如果你需要保留InvalidRowNumberException继承BadRequestException的结构，可以直接覆盖内置的BadRequestException映射，让所有BadRequestException子类都返回带消息的响应：

@ServerExceptionMapper
public class GlobalBadRequestExceptionMapper {
    public RestResponse<String> map(BadRequestException e) {
        String message = e.getMessage() != null ? e.getMessage() : "Invalid request parameters";
        return RestResponse.status(RestResponse.Status.BAD_REQUEST, message);
    }
}

方案3：使用JAX-RS标准ExceptionMapper接口 #

如果你更倾向于JAX-RS标准方式，可以实现ExceptionMapper接口并添加@Provider注解：

import jakarta.ws.rs.core.MediaType;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;

@Provider
public class InvalidRowNumberExceptionMapper implements ExceptionMapper<InvalidRowNumberException> {
    @Override
    public Response toResponse(InvalidRowNumberException e) {
        return Response.status(Response.Status.BAD_REQUEST)
                .entity(e.getMessage())
                .type(MediaType.TEXT_PLAIN)
                .build();
    }
}

验证步骤 #

1. 先将映射的状态码改为NOT_FOUND测试，确认响应状态码变为404，说明映射逻辑已生效；
2. 再改回BAD_REQUEST，即可得到带自定义消息的400响应。

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