Quarkus REST接口Integer查询参数值为空时抛出异常咨询

我用Quarkus RestEasyReactive实现了一个REST API控制器：

@Path("/hello")
public class HelloController {
  @GET
    @Produces({"application/json"})
    public RestResponse<Greeting> greet(@Min(0) @RestQuery int value) {
        return new Greeting("Hello" + value);
    }
}

当发送请求http://localhost:8080/hello?value=时，Quarkus返回404 Not Found错误。

查看RestEasy的ParameterHandler核心代码后发现：

if (defaultValue != null
                && (result == null || (isCollection && ((Collection) result).isEmpty()))) {
            result = defaultValue;
        }
        Throwable toThrow = null;
        if (converter != null && ((result != null) || isOptional)) {
            // spec says:
            /*
             * 3.2 Fields and Bean Properties
             * if the field or property is annotated with @MatrixParam, @QueryParam or @PathParam then an implementation
             * MUST generate an instance of NotFoundException (404 status) that wraps the thrown exception and no
             * entity; if the field or property is annotated with @HeaderParam or @CookieParam then an implementation
             * MUST generate an instance of BadRequestException (400 status) that wraps the thrown exception and
             * no entity.
             * 3.3.2 Parameters
             * Exceptions thrown during construction of @FormParam annotated parameter values are treated the same as if
             * the parameter were annotated with @HeaderParam.
             */
            switch (parameterType) {
                case COOKIE:
                case HEADER:
                case FORM:
                    try {
                        result = converter.convert(result);
                    } catch (WebApplicationException x) {
                        toThrow = x;
                    } catch (Throwable x) {
                        log.debug("Unable to handle parameter", x);
                        toThrow = new BadRequestException(x);
                    }
                    break;
                case MATRIX:
                case PATH:
                case QUERY:
                    try {
                        result = converter.convert(result);
                    } catch (WebApplicationException x) {
                        toThrow = x;
                    } catch (Throwable x) {
                        log.debug("Unable to handle parameter", x);
                        toThrow = new NotFoundException(x);
                    }
                    break;

问题根源是：空的value参数导致result变量为空，Integer转换器尝试转换空值时抛出异常，按照JAX-RS规范，查询参数转换异常必须返回404。

目前临时方案是将查询参数定义为String再手动转Integer，但不够优雅高效。想问：有没有办法在Quarkus里覆盖这个行为？或者我对场景的处理理解有误？

1. 使用Optional<Integer>替代原始类型 #

将参数类型改为Optional<Integer>，空参数会被包装为空Optional，不会触发转换器异常，后续可自行处理默认值或校验：

public RestResponse<Greeting> greet(@Min(0) @RestQuery Optional<Integer> value) {
    int actualValue = value.orElse(0); // 按需设置默认值，比如0
    return RestResponse.ok(new Greeting("Hello" + actualValue));
}

2. 给参数设置默认值 #

通过@RestQuery的defaultValue属性指定默认值，空参数会自动使用该值，避免空值转换：

public RestResponse<Greeting> greet(@Min(0) @RestQuery(defaultValue = "0") int value) {
    return RestResponse.ok(new Greeting("Hello" + value));
}

3. 自定义参数转换器 #

实现Converter<String, Integer>并注册，主动处理空字符串场景，避免抛出异常：

@Provider
public class EmptyStringToIntegerConverter implements Converter<String, Integer> {
    @Override
    public Integer convert(String value) {
        if (value == null || value.isEmpty()) {
            return 0; // 空值时返回默认值，或根据业务需求调整
        }
        return Integer.parseInt(value);
    }
}

4. 全局异常处理 #

注册ExceptionMapper，捕获NotFoundException并判断是否为查询参数转换导致的异常，将其替换为400错误返回：

@Provider
public class QueryParamExceptionMapper implements ExceptionMapper<NotFoundException> {
    @Override
    public Response toResponse(NotFoundException exception) {
        Throwable cause = exception.getCause();
        if (cause instanceof NumberFormatException) {
            return Response.status(Response.Status.BAD_REQUEST)
                    .entity("无效的查询参数值")
                    .build();
        }
        // 其他场景仍返回404
        return Response.status(Response.Status.NOT_FOUND)
                .entity(exception.getMessage())
                .build();
    }
}

规范说明 #

你看到的代码注释是JAX-RS规范要求：@QueryParam转换异常必须返回404，因此Quarkus的默认行为是符合规范的。如果你的业务场景需要返回400，可通过上述全局异常处理或自定义转换器覆盖默认逻辑。

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