在 Spring 开发中，@Validated 注解常用于参数校验，它依赖于 Hibernate Validator 或 JSR 303 实现的 Bean Validation。使用 @Validated 可以确保方法参数或对象属性符合预定义的约束条件，如非空、字符串长度、数值范围等。然而，在实际开发中，@Validated 有时可能会失效，导致参数校验未生效的问题。本文将详细分析这些失效场景并给出对应的解决方案。

一、常见的 @Validated 失效场景

1. 方法所在类未被 Spring 管理

@Validated 注解依赖 Spring 的 AOP（Aspect-Oriented Programming）代理机制来拦截方法并进行参数校验。如果一个类没有被 Spring 管理，@Validated 将无法生效。常见的情况包括使用 new 关键字创建对象。

示例：

public class UserService {
    @Validated
    public void createUser(@NotNull String username) {
        // 业务逻辑
    }
}

// 在某处手动创建该类实例
UserService userService = new UserService();
userService.createUser(null); // 校验无效

解决方案：

确保类被 Spring 容器管理，可以通过以下方式解决：

• 使用 @Component 或其他类似注解（如 @Service, @Controller）将类纳入 Spring 容器管理。
• 使用 @Autowired 或 ApplicationContext.getBean() 来获取该类的实例。

修改后代码：

@Service
public class UserService {
    @Validated
    public void createUser(@NotNull String username) {
        // 业务逻辑
    }
}

// 使用 Spring 容器获取 UserService 实例
@Autowired
private UserService userService;

userService.createUser(null); // 触发校验异常

2. 自调用导致 @Validated 失效

如果在类的内部调用自身的 @Validated 方法，由于 Spring AOP 代理的特性，内部方法调用不会触发代理逻辑，从而导致参数校验失效。

示例：

@Service
public class UserService {
    @Validated
    public void createUser(@NotNull String username) {
        // 业务逻辑
    }

    public void processUser() {
        // 内部调用
        createUser(null); // 校验无效
    }
}

解决方案：

• 避免内部自调用，可以通过外部类或使用 Spring 的 AopContext 来解决。
• 通过 AopContext.currentProxy() 获取当前代理对象。

修改后代码：

@Service
public class UserService {
    @Validated
    public void createUser(@NotNull String username) {
        // 业务逻辑
    }

    public void processUser() {
        // 使用代理对象调用
        ((UserService) AopContext.currentProxy()).createUser(null); // 触发校验异常
    }
}

3. 缺少 @Validated 注解或使用 @Valid

@Validated 注解必须放在类或方法上才能生效。有时开发者可能会错误地使用 @Valid，该注解通常用于嵌套对象校验，而非方法级别参数校验。

示例：

@Service
public class UserService {
    public void createUser(@Valid @NotNull String username) {
        // 业务逻辑
    }
}

在这种情况下，@Valid 对基本类型参数（如 String）无效，导致校验失效。

解决方案：

• 使用 @Validated 注解在类或方法上，确保方法参数校验生效。

修改后代码：

@Service
@Validated
public class UserService {
    public void createUser(@NotNull String username) {
        // 业务逻辑
    }
}

4. 校验作用于控制器但未配置 @Validated

在 Spring MVC 中，参数校验常用于控制器方法的请求参数。如果控制器没有配置 @Validated，即使参数上有校验注解，也不会触发校验。

示例：

@RestController
public class UserController {
    @PostMapping("/user")
    public ResponseEntity<String> createUser(@NotNull @RequestBody User user) {
        // 业务逻辑
        return ResponseEntity.ok("User created");
    }
}

解决方案：

确保在控制器类或方法上使用 @Validated，如在类级别或方法级别上应用该注解。

修改后代码：

@RestController
@Validated
public class UserController {
    @PostMapping("/user")
    public ResponseEntity<String> createUser(@NotNull @RequestBody User user) {
        // 业务逻辑
        return ResponseEntity.ok("User created");
    }
}

5. 方法级别校验与接口类冲突

在使用接口定义服务时，如果将 @Validated 放在接口方法上，而不是在实现类上，可能导致校验无法生效。因为代理通常会作用于实现类，而不是接口。

示例：

public interface UserService {
    void createUser(@NotNull String username);
}

@Service
public class UserServiceImpl implements UserService {
    @Override
    public void createUser(String username) {
        // 业务逻辑
    }
}

这里，@NotNull 校验不会生效。

解决方案：

• 将 @Validated 放在实现类上，或在实现类方法上使用 @Validated 注解。
• 确保 @Validated 只作用于最终实际调用的方法上。

修改后代码：

@Service
@Validated
public class UserServiceImpl implements UserService {
    @Override
    public void createUser(@NotNull String username) {
        // 业务逻辑
    }
}

6. 校验分组使用错误

@Validated 支持分组校验，即根据不同的校验场景定义不同的校验组。如果在使用 @Validated 时未指定正确的校验组，可能导致校验不生效。

示例：

public class User {
    @NotNull(groups = CreateGroup.class)
    private String username;
}

@Service
public class UserService {
    @Validated(UpdateGroup.class) // 使用了错误的校验组
    public void createUser(@Valid User user) {
        // 业务逻辑
    }
}

解决方案：

• 确保指定了正确的校验组。
• 如果没有使用分组，可以省略 groups 参数。

修改后代码：

@Service
@Validated(CreateGroup.class)
public class UserService {
    public void createUser(@Valid User user) {
        // 业务逻辑
    }
}

二、总结

@Validated 作为 Spring 中常用的参数校验注解，能够帮助开发者在业务逻辑之前进行参数合法性校验，提升系统的鲁棒性。然而，开发过程中可能由于 Spring 容器管理、AOP 自调用、注解使用错误等多种原因导致其失效。通过本文对常见失效场景的分析及解决方案的讲解，希望开发者能够在项目中正确使用 @Validated，确保参数校验的有效性。

主要解决方案：

1. 确保类被 Spring 容器管理。
2. 避免自调用，使用代理调用方法。
3. 在需要校验的地方正确使用 @Validated，而不是 @Valid。
4. 校验控制器方法时，确保正确配置 @Validated。
5. 确保接口实现类的校验注解正确配置。
6. 合理使用校验分组，确保选择正确的校验组。