如何优雅处理 JSON 字符串到 BigInteger 的反序列化异常-java教程-PHP中文网

如何优雅处理 JSON 字符串到 BigInteger 的反序列化异常

当用户向 Spring Boot API 传递非法字符串（如 "!@#$^!&*"）试图绑定到 BigInteger 字段时，Jackson 默认抛出 HttpMessageNotReadableException；本文介绍不修改字段类型的前提下，通过自定义反序列化器与全局异常处理实现健壮的输入校验与友好错误提示。

当用户向 spring boot api 传递非法字符串（如 `"!@#$^!&*"`）试图绑定到 `biginteger` 字段时，jackson 默认抛出 `httpmessagenotreadableexception`；本文介绍不修改字段类型的前提下，通过自定义反序列化器与全局异常处理实现健壮的输入校验与友好错误提示。

在 RESTful 接口中，BigInteger 常用于接收大整数（如 ID、金额等），但 Jackson 默认仅支持标准数字格式（如 "123"、"0"）或科学计数法字符串，对任意非数字字符串（如 "abc"、"!@#"）会直接抛出 JsonMappingException，最终触发 HttpMessageNotReadableException 并返回 HTTP 400，且默认错误信息冗长、不面向前端友好。

✅ 解决方案：自定义 BigInteger 反序列化器

我们可继承 StdDeserializer，在反序列化过程中主动捕获 NumberFormatException，并抛出语义明确的 IllegalArgumentException：

public class BigIntegerDeserializer extends StdDeserializer<biginteger> {
    protected BigIntegerDeserializer() {
        super(BigInteger.class);
    }

    @Override
    public BigInteger deserialize(JsonParser parser, DeserializationContext context)
            throws IOException {
        String text = parser.getText();
        if (text == null || text.trim().isEmpty()) {
            throw new IllegalArgumentException("Value cannot be null or empty.");
        }
        try {
            // 支持纯数字字符串（含负号），避免 Long 范围限制 → 改用 new BigInteger(text)
            return new BigInteger(text.trim());
        } catch (NumberFormatException e) {
            throw new IllegalArgumentException("Value must be a valid integer string.");
        }
    }
}</biginteger>

⚠️ 注意：原答案中使用 BigInteger.valueOf(Long.parseLong(...)) 存在严重缺陷——它先转 long，会丢失超出 long 范围的大数（如 "99999999999999999999"），正确做法是直接调用 new BigInteger(text)。

接着，在 DTO 字段上声明该反序列化器：

Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载

@Getter
@Setter
public class InputRequest {
    @JsonDeserialize(using = BigIntegerDeserializer.class)
    private BigInteger num;
}

✅ 全局异常处理：统一返回结构化错误响应

为避免暴露堆栈信息，并向客户端返回清晰提示，建议在 @ControllerAdvice 中统一捕获并解析根因：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<map string>> handleHttpMessageNotReadable(
            HttpMessageNotReadableException ex) {
        // 提取原始业务异常（即 deserialize 中抛出的 IllegalArgumentException）
        Throwable rootCause = ExceptionUtils.getRootCause(ex);
        String message = (rootCause != null) ? rootCause.getMessage() : "Invalid request body.";

        Map<string string> error = Map.of("error", message);
        return ResponseEntity.badRequest().body(error);
    }
}</string></map>

✅ 依赖提示：ExceptionUtils 来自 Apache Commons Lang（org.apache.commons.lang3.exception.ExceptionUtils），若未引入，可添加 Maven 依赖：
<dependency><groupid>org.apache.commons</groupid><artifactid>commons-lang3</artifactid><version>3.12.0</version></dependency>

? 补充建议

若需更严格校验（如禁止前导零、限制位数），可在 deserialize 方法中加入正则匹配或长度检查；
对于高频调用接口，可考虑将反序列化器注册为全局 Bean（通过 SimpleModule.addDeserializer + Jackson2ObjectMapperBuilder），避免重复注解；
前端应配合做基础格式校验（如 type="number" 或正则 /^-?\d+$/），但服务端永远不可信任客户端输入。

通过以上组合方案，既保留了 BigInteger 的语义与精度能力，又实现了非法输入的拦截、标准化错误反馈与良好的可维护性。