Spring Boot 3.2.3升级后@Pattern校验UUID报错，求解决方案

升级Spring Boot到3.2.3版本后，用@Pattern注解校验java.util.UUID类型的@PathVariable时，会触发以下错误：

Caused by 'jakarta.validation.UnexpectedTypeException: HV000030: No validator could be found for constraint 'jakarta.validation.constraints.Pattern' validating type 'java.util.UUID'

能不能直接移除@Pattern注解？ #

• 常规场景下完全可以直接移除：Spring MVC会自动对声明为UUID类型的@PathVariable做格式校验，若传入的字符串不符合UUID规范，会直接返回400 Bad Request，无需额外的@Pattern注解。
• 特殊场景需谨慎：如果业务要求UUID必须符合特定格式（比如仅允许UUIDv4），直接移除@Pattern无法满足这类定制化校验需求，需要用其他方案替代。

替代方案：自定义校验注解 #

如果需要同时支持字符串和UUID类型的校验，或者有定制化格式要求，可以自己实现一个通用的UUID校验注解：

// 自定义校验注解
@Target({METHOD, FIELD, PARAMETER})
@Retention(RUNTIME)
@Constraint(validatedBy = UUIDValidator.class)
public @interface ValidUUID {
    String message() default "无效的UUID格式";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

// 校验器实现
public class UUIDValidator implements ConstraintValidator<ValidUUID, Object> {
    @Override
    public boolean isValid(Object value, ConstraintValidatorContext context) {
        if (value == null) return true; // 允许空值，若不允许可改为false
        
        String uuidStr;
        if (value instanceof UUID) {
            uuidStr = value.toString();
        } else if (value instanceof String) {
            uuidStr = (String) value;
        } else {
            return false;
        }
        
        try {
            UUID.fromString(uuidStr);
            // 可选：添加版本校验，比如仅允许UUIDv4
            // UUID uuid = UUID.fromString(uuidStr);
            // return uuid.version() == 4;
            return true;
        } catch (IllegalArgumentException e) {
            return false;
        }
    }
}

使用时，无论是String还是UUID类型的@PathVariable，都可以通过@ValidUUID注解完成校验，既兼容字符串类型的格式检查，也支持UUID类型的参数校验。

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