Spring Boot自定义校验报错：找不到匹配String类型的LastName校验器

核心报错原因 #

这个错误本质是Spring无法找到与@LastName注解绑定的校验器实现，同时你还存在一个逻辑误区：单字段校验器无法获取同实体的其他字段（比如firstName），根本没法实现「两个字段不能相等」的校验逻辑。下面是分步解决方法：

1. 修正校验逻辑：改用类级别自定义校验 #

要对比同一个实体里的firstName和lastName，必须用类级别的校验（字段级校验只能拿到当前字段的值，访问不到其他字段）。

1.1 重新定义类级校验注解 #

import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

@Target({ElementType.TYPE}) // 目标标注在类上
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = UserNameValidator.class) // 绑定对应的校验器类
public @interface UserNameCheck {
    String message() default "firstName与lastName不能相等";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

注意：Spring Boot 3+用jakarta.validation包，Spring Boot 2.x用javax.validation包，别导错包。

1.2 编写类级校验器 #

import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import org.springframework.stereotype.Component;

@Component // 让Spring扫描并管理这个校验器类
public class UserNameValidator implements ConstraintValidator<UserNameCheck, User> {

    @Override
    public void initialize(UserNameCheck constraintAnnotation) {
        // 初始化逻辑，不需要可以留空
    }

    @Override
    public boolean isValid(User user, ConstraintValidatorContext context) {
        // 处理空值情况，避免空指针
        if (user.getFirstName() == null || user.getLastName() == null) {
            return true; // 若业务要求空值也报错，这里改成false即可
        }
        // 核心校验逻辑：两个字段不相等则返回true（校验通过）
        return !user.getFirstName().equals(user.getLastName());
    }
}

1.3 在User实体上添加类级注解 #

@UserNameCheck // 把注解加在类上，而非单个字段
public class User {
    private String firstName;
    private String lastName;

    // 此处省略getter、setter、构造方法
}

2. 修复原注解的配置问题（若你仍需要字段级校验） #

如果只是单纯解决「No validator could be found」报错，原字段级注解必须正确配置validatedBy属性，同时校验器要被Spring管理：

// 原@LastName注解的正确写法
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = LastNameValidator.class) // 必须指定对应的校验器类
public @interface LastName {
    String message() default "自定义提示信息";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

校验器类要加@Component，确保Spring能扫描到：

@Component
public class LastNameValidator implements ConstraintValidator<LastName, String> {
    @Override
    public void initialize(LastName constraintAnnotation) {}

    @Override
    public boolean isValid(String lastName, ConstraintValidatorContext context) {
        // 这里只能拿到lastName的值，没法对比firstName，所以不适合你的需求
        return true;
    }
}

3. 其他必查项 #

• 控制器方法必须启用校验：在参数前加@Valid或@Validated

  @PostMapping("/save")
  public String saveUser(@Valid User user, BindingResult result) {
      if (result.hasErrors()) {
          // 处理校验错误
          return "user-form";
      }
      // 保存逻辑
      return "success";
  }
  

• Maven依赖要正确：确保引入validation starter

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-validation</artifactId>
  </dependency>
  

• 校验器类要在Spring扫描路径下：如果校验器所在包没被@SpringBootApplication默认扫描到，需手动添加@ComponentScan指定包路径。

内容的提问来源于stack exchange，提问作者Theow Meng Ang