如何在Quarkus中妥善处理JSON转类实例的转换错误

问题根源 #

在resteasy-reactive-jackson的请求体自动映射流程中，JSON到DTO的类型转换错误发生在JAX-RS资源方法执行之前的请求解析阶段，Quarkus默认会直接包装并返回错误，普通的全局ExceptionMapper可能未覆盖到对应的异常类型（比如Jackson的JsonProcessingException或Quarkus包装后的BadRequestException）。

最优解决方案 #

1. 编写针对Jackson解析异常的全局ExceptionMapper #

创建两个Provider类，分别处理Jackson原生异常和Quarkus包装后的异常，确保覆盖所有转换错误场景：

处理Jackson原生解析/映射异常

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.JsonMappingException;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;

@Provider
public class JacksonProcessingExceptionMapper implements ExceptionMapper<JsonProcessingException> {

    @Override
    public Response toResponse(JsonProcessingException ex) {
        String errorMsg;
        if (ex instanceof JsonMappingException mappingEx) {
            // 提取具体的字段和预期类型，生成友好提示
            var field = mappingEx.getPath().getFirst();
            errorMsg = String.format("字段「%s」类型不匹配，预期类型为%s",
                    field.getFieldName(),
                    mappingEx.getTargetType().getSimpleName());
        } else {
            errorMsg = "请求JSON格式无效，请检查语法";
        }

        return Response.status(Response.Status.BAD_REQUEST)
                .entity(new ErrorResponse(errorMsg))
                .build();
    }

    // 自定义统一错误响应体
    public static class ErrorResponse {
        public String message;

        public ErrorResponse(String message) {
            this.message = message;
        }
    }
}

处理Quarkus包装后的BadRequestException

import com.fasterxml.jackson.core.JsonProcessingException;
import jakarta.ws.rs.BadRequestException;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;

@Provider
public class WrappedJacksonExceptionMapper implements ExceptionMapper<BadRequestException> {

    @Override
    public Response toResponse(BadRequestException ex) {
        Throwable cause = ex.getCause();
        if (cause instanceof JsonProcessingException jacksonEx) {
            // 复用原生异常的处理逻辑
            String errorMsg = "请求参数错误：" + jacksonEx.getOriginalMessage();
            return Response.status(Response.Status.BAD_REQUEST)
                    .entity(new ErrorResponse(errorMsg))
                    .build();
        }
        // 非Jackson异常，按默认逻辑返回
        return Response.status(ex.getResponse().getStatus())
                .entity(new ErrorResponse(ex.getMessage()))
                .build();
    }

    public static class ErrorResponse {
        public String message;

        public ErrorResponse(String message) {
            this.message = message;
        }
    }
}

2. 配置Quarkus确保自定义ExceptionMapper优先级 #

在application.properties中添加以下配置，关闭默认异常映射器并提升自定义映射器的优先级：

# 禁用Quarkus默认的全局异常映射器
quarkus.error-handling.default-exception-mapper.enabled=false
# 提升自定义ExceptionMapper的优先级，确保先被执行
quarkus.resteasy-reactive.exception-mapper.priority=1000

3. 可选：自定义反序列化器兼容特殊转换场景 #

如果需要兼容部分字符串转布尔的场景（比如传入"true"/"false"字符串），可以给DTO字段添加自定义反序列化器，避免无意义的异常：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import java.io.IOException;

public class UserDTO {
    private String name;

    @JsonDeserialize(using = FlexibleBooleanDeserializer.class)
    private boolean isMinor;

    // getter/setter
}

class FlexibleBooleanDeserializer extends JsonDeserializer<Boolean> {
    @Override
    public Boolean deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String value = p.getText().trim();
        return switch (value.toLowerCase()) {
            case "true", "1" -> true;
            case "false", "0" -> false;
            default -> throw new IOException(String.format("无法将值「%s」转换为布尔类型", value));
        };
    }
}

效果验证 #

完成上述配置后，当请求体中isMinor字段传入字符串（比如"yes"）时，自定义ExceptionMapper会捕获转换异常，返回你定义的友好错误响应，无需再手动处理JsonObject映射。

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