当用户向 biginteger 字段提交非数字字符串（如 "!@#$%^&*"）时，spring 默认抛出 httpmessagenotreadableexception；本文介绍通过自定义 jackson 反序列化器 + 全局异常处理器，实现精准校验与友好错误响应，无需更改字段类型。
当用户向 biginteger 字段提交非数字字符串（如 "!@#$%^&*"）时，spring 默认抛出 httpmessagenotreadableexception；本文介绍通过自定义 jackson 反序列化器 + 全局异常处理器，实现精准校验与友好错误响应，无需更改字段类型。
在基于 Spring Boot 的 REST API 开发中，若接口接收 BigInteger 类型参数（例如用于处理超长整数 ID 或大额金额），而前端误传或恶意传入非法字符串（如 "abc"、"!@#$%^&*"），Jackson 默认反序列化机制会直接抛出 HttpMessageNotReadableException，并返回 HTTP 400 错误及冗长堆栈信息——这既不安全也不友好。
✅ 解决方案：自定义反序列化器 + 统一异常处理
1. 编写专用 BigInteger 反序列化器
为避免全局影响，推荐针对特定字段定制逻辑。以下反序列化器尝试将字符串解析为 long 后转为 BigInteger（兼顾性能与兼容性），并在失败时抛出语义明确的 IllegalArgumentException：
public class BigIntegerDeserializer extends StdDeserializer<BigInteger> {
protected BigIntegerDeserializer() {
super(BigInteger.class);
}
@Override
public BigInteger deserialize(JsonParser jsonParser, DeserializationContext context)
throws IOException {
String text = jsonParser.getText();
if (text == null || text.trim().isEmpty()) {
throw new IllegalArgumentException("Value cannot be null or empty.");
}
try {
// 优先尝试 long 转换（比 new BigInteger(String) 更严格，拒绝带空格/前导零等）
return BigInteger.valueOf(Long.parseLong(text.trim()));
} catch (NumberFormatException e) {
throw new IllegalArgumentException("Value must be a valid integer string.");
}
}
}⚠️ 注意：BigInteger(String) 构造函数本身支持科学计数法和空格，但业务中通常需更严格的整数校验。此处用 Long.parseLong() 是一种常见折中；如需完全支持任意精度整数字符串，可改用 new BigInteger(text.trim()) 并捕获其 NumberFormatException。
2. 在 DTO 字段上启用自定义反序列化器
仅对目标字段添加注解，不影响其他 BigInteger 使用场景：
@Getter
@Setter
public class InputRequest {
@JsonDeserialize(using = BigIntegerDeserializer.class)
private BigInteger num;
}3. 全局捕获并标准化错误响应
在 @ControllerAdvice 中统一处理 HttpMessageNotReadableException，提取底层业务异常消息，返回结构化 JSON 错误：
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(HttpMessageNotReadableException.class)
public ResponseEntity<Map<String, String>> handleHttpMessageNotReadable(
HttpMessageNotReadableException ex) {
// 提取原始业务异常（如 IllegalArgumentException）
Throwable cause = ExceptionUtils.getRootCause(ex);
String message = (cause != null) ? cause.getMessage() : "Invalid request payload.";
Map<String, String> error = Map.of("error", message);
return ResponseEntity.badRequest().body(error);
}
}✅ 依赖提示：ExceptionUtils 来自 Apache Commons Lang（org.apache.commons.lang3.exception.ExceptionUtils），若未引入，可改用 Throwable.getCause() 循环获取，或直接检查 ex.getCause()。
✅ 最终效果
- 输入：{"num": "!@#$%"} → 响应：{"error":"Value must be a valid integer string."}，HTTP 400
- 输入：{"num": "123"} → 正常处理
- 输入：{"num": ""} 或 null → 触发空值校验（配合 @NotNull 可进一步强化）
该方案保持 BigInteger 类型不变，兼顾安全性、可读性与可维护性，是生产环境推荐的健壮实践。
