如何阻止Java API对无效UUID自动补0并返回错误输入提示

问题根因 #

JDK 原生的 java.util.UUID.fromString() 方法本身不会做自动补0逻辑，遇到分段长度不符合 8-4-4-4-12 规则的输入会直接抛出 IllegalArgumentException。你遇到的自动补全行为几乎都来自框架层的宽松UUID反序列化配置，比如 Jackson 的 UUIDDeserializer 开启了宽松模式、或者 Spring Web 的参数转换器用了兼容解析逻辑。

不同场景的修复方案 #

• 场景1：使用 Jackson 做 JSON 参数反序列化
  关闭 Jackson 的宽松 UUID 解析配置即可，如果是 Spring Boot 项目直接在配置文件新增规则：

  spring:
    jackson:
      deserialization:
        ACCEPT_LENIENT_UUID: false
  

  独立使用 Jackson 的场景直接手动配置 ObjectMapper：

  ObjectMapper mapper = new ObjectMapper();
  mapper.disable(DeserializationFeature.ACCEPT_LENIENT_UUID);
  

  关闭宽松解析后，Jackson 遇到不符合标准格式的 UUID 会直接抛出反序列化异常，你只需要统一捕获该异常转为 400 Bad Request 响应即可。

• 场景2：使用 URL 路径参数/Query 参数绑定 UUID
  Spring MVC 部分版本的默认 UUID 转换器会做宽松解析，你可以自定义一个严格的 UUID 转换器覆盖默认实现：

  @Component
  public class StrictUUIDConverter implements Converter<String, UUID> {
      @Override
      public UUID convert(String source) {
          if (source == null) {
              return null;
          }
          // 正则严格校验标准UUID格式，不允许缺段少位
          if (!source.matches("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$")) {
              throw new IllegalArgumentException("无效的UUID格式");
          }
          return UUID.fromString(source);
      }
  }
  

• 场景3：手动调用了第三方 UUID 解析工具
  直接替换为 JDK 原生的 UUID.fromString() 方法，或者给你使用的第三方工具开启严格格式校验参数即可。

全局异常适配示例 #

新增全局异常处理器统一捕获参数解析异常，返回你需要的 Bad Input 提示：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler({IllegalArgumentException.class, JsonProcessingException.class, TypeMismatchException.class})
    public ResponseEntity<ErrorInfo> handleBadInput(Exception e) {
        ErrorInfo error = new ErrorInfo(400, "Bad Input", "请求参数包含无效UUID格式");
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }
}

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