Java非REST API调用场景下@Valid、@Size参数校验未触发问题

• 检查运行环境配置
  如果你使用Spring/SpringBoot框架：
  1. 确认已引入校验依赖，SpringBoot3+需单独引入spring-boot-starter-validation依赖
  2. 类C必须被Spring容器托管，需添加@Service、@RestController、@Component等托管注解，自行new的C对象调用方法不会触发校验
• 检查注解配置是否正确
  1. 类C上必须添加@Validated注解，这是Spring开启方法级参数校验的必要开关，仅在方法参数上加@Valid不会生效
  2. 确认所有注解导包正确：
     • @Size需导入jakarta.validation.constraints.Size（SpringBoot3+）或javax.validation.constraints.Size（SpringBoot2.x及更早版本）
     • @Valid需导入jakarta.validation.Valid或javax.validation.Valid
• 检查方法访问权限
  Spring基于代理的AOP仅能拦截public方法，你当前定义的methodThatUsesA为默认包访问权限，需将方法修饰符改为public
• 检查调用方式
  如果是类C内部的其他方法直接调用methodThatUsesA，属于类自调用，走的是原生对象而非Spring代理对象，不会触发校验逻辑。需改为通过注入的代理对象调用该方法，或把校验逻辑拆分到单独的托管Bean中
• 非Spring环境手动触发校验
  如果你没有使用Spring框架，注解不会自动触发校验，需手动调用Validator实例执行校验：

  ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
  Validator validator = factory.getValidator();
  // 校验对象A
  Set<ConstraintViolation<A>> violations = validator.validate(a);
  if (!violations.isEmpty()) {
      // 处理校验异常逻辑
  }
  

正确配置示例 #

// 类A无需改动，保持原有@Size注解即可
import jakarta.validation.constraints.Size;

public final class A {
    @Size(min = 1, max = 15, message = "Error")
    private final String id;
    private final String anotherString;
    // 构造方法、getter省略
}

// 类C的正确写法
import org.springframework.validation.annotation.Validated;
import jakarta.validation.Valid;

@Validated
@Service
public final class C {
    public void methodThatUsesA(@Valid final A a, final B b)  {
        // 业务逻辑
    }
}

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