spring boot 实现条件校验的核心做法是自定义 constraintvalidator，在 isvalid 方法中根据当前对象的其他字段值动态决定校验是否通过。例如，当需要实现“如果订单状态为已支付，则必须提供支付流水号”时，只需编写一个校验器类，并在其中判断 status 字段的值，若满足特定条件则检查 payno 是否为空，否则直接返回 true。
如何定义支持多字段依赖的自定义注解
要实现上述逻辑，首先需要定义一个注解，该注解通常不需要参数，因为校验逻辑完全依赖于被校验对象自身的属性关系。这个注解将作为标记，告诉 Spring Boot 使用哪个校验器来处理该字段。
@Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Constraint(validatedBy = PayOrderValidator.class)
public @interface ValidPayOrder {
String message() default "支付订单必须包含支付流水号";
Class>[] groups() default {};
Class extends Payload>[] payload() default {};
}
在注解定义中，validatedBy 属性指定了具体的校验器类 PayOrderValidator。这样，当 Spring Boot 启动并扫描到带有此注解的字段时，就会实例化对应的校验器。注意，这里没有定义额外的配置参数，因为校验规则是硬编码在 Validator 中的。如果需要更复杂的配置，可以在注解中添加属性，并在 Validator 的 initialize 方法中接收这些值。
如何实现基于上下文的动态校验逻辑
接下来是实现核心逻辑的校验器类。它实现了 ConstraintValidator 接口，泛型参数分别对应自定义注解和待校验的对象类型。在 isValid 方法中，我们可以访问整个对象实例，从而获取其他字段的值进行联合判断。
public class PayOrderValidator implements ConstraintValidator<validpayorder order> {
@Override
public boolean isValid(Order order, ConstraintValidatorContext context) {
if (order == null) {
return true; // 空值由 @NotNull 处理
}
// 假设 Order 类中有 getStatus() 和 getPayNo() 方法
if ("PAID".equals(order.getStatus())) {
if (order.getPayNo() == null || order.getPayNo().isEmpty()) {
// 禁用默认的消息模板，使用自定义消息
context.disableDefaultConstraintViolation();
context.buildConstraintViolationWithTemplate("支付订单必须提供支付流水号")
.addPropertyNode("payNo")
.addConstraintViolation();
return false;
}
}
return true;
}
}</validpayorder>
在这个实现中，我们首先检查对象是否为空。然后，根据 status 字段的值进行分支判断。如果状态是 PAID，则进一步检查 payNo。如果 payNo 为空，我们通过 context 构建一个针对 payNo 字段的约束违规信息，并返回 false 以触发校验失败。这种方式的优点是校验逻辑与业务模型紧密耦合，能够灵活处理任意复杂的字段间依赖关系。
当订单状态为未支付时校验器会返回什么结果
在上述代码逻辑中，如果传入的 Order 对象的 status 不是 PAID（例如是 PENDING 或 CANCELLED），校验器会跳过对 payNo 的检查，直接执行最后的 return true; 语句。这意味着对于非支付状态的订单，即使 payNo 字段为空或缺失，校验也会通过，不会抛出任何异常或错误提示。这是符合业务预期的，因为只有支付成功的订单才强制要求有流水号记录。
