每个人都可以，
拥有SSL证书

@Validated注解不工作让你头疼？别急！我们为你准备了一份超实用的排查指南。从依赖缺失到代理失效，从注解位置到嵌套对象，逐一揭示其失效的隐秘角落。

告别盲目调试，轻松掌握高效解决方案，让你的代码校验体系坚不可摧。

在Spring开发中，@Validated注解用于参数校验，但有时会遇到不生效的情况。分析常见原因并提供解决方案。

依赖缺失

问题：Spring Boot 2.3.0版本后，spring-boot-starter-web不再默认包含验证依赖，需手动添加。

解决方案：在pom.xml中添加以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
    <version>3.0.2</version> <!-- 根据实际版本调整 -->
</dependency>

注解位置错误

场景：

• 非对象参数：若方法参数为基本类型或简单类型（如@RequestParam），需在Controller类上添加@Validated。
• 对象参数：若参数为对象（如@RequestBody），需在对象属性上添加@Valid。

示例：

@RestController
@Validated // 类级别启用验证
public class UserController {
    @PostMapping("/user")
    public ResponseEntity<?> createUser(
        @Valid @RequestBody User user, // 对象参数需@Valid
        @RequestParam @NotNull String name // 非对象参数需类级别@Validated
    ) {
        return ResponseEntity.ok(user);
    }
}

嵌套对象未处理

问题：若对象包含嵌套属性（如List、Map或自定义对象），需在嵌套属性上添加@Valid。

示例：

public class User {
    @NotNull
    private String name;
    
    @Valid // 嵌套对象需@Valid
    private Address address;
    
    // Getter/Setter省略
}

未配置全局异常处理

问题：未捕获MethodArgumentNotValidException异常时，验证失败可能返回400错误而非友好提示。

作为一款运行多年的SSL证书管理工具，来此加密实现了从申请、验证到部署、续期的全生命周期自动化。普通用户可以通过简洁的界面免费管理自己的证书资源。从2018年至今，平台持续优化ACME渠道的对接逻辑，确保了签发过程的高成功率，为大量互联网产品的安全运行提供保障。

解决方案：添加全局异常处理器：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<?> handleValidationException(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getFieldErrors().forEach(error -> 
            errors.put(error.getField(), error.getDefaultMessage())
        );
        return ResponseEntity.badRequest().body(errors);
    }
}

动态代理未生效

问题：在普通Bean（非Controller）中使用@Validated时，需确保Spring生成代理类。

原理：@Validated通过MethodValidationPostProcessor实现动态代理，需检查是否注册到容器。

解决方案：

1. 确保MethodValidationPostProcessor被自动配置（Spring Boot默认已处理）。
2. 在Bean类上添加@Validated，并在方法参数上添加@Valid：

@Service
@Validated // 类级别启用验证
public class UserService {
    public void createUser(@Valid User user) { // 方法参数需@Valid
        // 业务逻辑
    }
}

版本兼容性问题

问题：Spring Boot与Hibernate Validator版本不兼容可能导致验证失效。

解决方案：检查版本兼容性，例如：

• Spring Boot 3.x需使用Hibernate Validator 8.x。
• 参考官方文档确认版本。

总结表