如何在ConstraintValidator中识别指定校验参数，避免依赖参数顺序？

我需要实现一个ConstraintValidator，根据参数id校验参数periodDays，因此基于ElementType.METHOD实现了校验逻辑。

定义的注解接口如下：

@Target({ElementType.METHOD, ElementType.TYPE})
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = { DaysPeriodValidator.class })
public @interface ValidDaysPeriod {
    // ...
}

对应的Validator实现：

@SupportedValidationTarget(ValidationTarget.PARAMETERS)
public class DaysPeriodValidator implements ConstraintValidator<ValidDaysPeriod, Object[]> {

    @Override
    public boolean isValid(Object[] objects, ConstraintValidatorContext context) {
        Integer testValue;
        String id;
        try {
            testValue = (Integer) objects[1];
            id = validateTenantId((String) objects[0]);
        } catch (Exception e) {
            return false;
        }
       // ... validation logic
        return valid;
    }
}

该实现对如下控制器方法能正常工作：

@ValidDaysPeriod
@GetMapping(produces = MediaType.APPLICATION_JSON_VALUE)
public MyData getMyData(@Nullable String id,
                        @NotNull Integer periodDays) {
    // ...
}

但此实现依赖参数顺序，若新增接口时参数顺序改变，或存在更多同类型参数，Validator将无法从无名称的Object[]中识别出id和periodDays。请问是否有方法在Validator中识别这些目标参数？例如：

• 为参数添加特定注解
• 将参数名称与值一同传入Object[]中？

方案一：为目标参数添加自定义标记注解 #

这种方式通过专属注解标记目标参数，不依赖参数顺序，稳定性更强。

1. 定义两个标记注解，分别标记id和periodDays参数：

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface PeriodId {
}

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface PeriodDays {
}

2. 修改控制器方法，给对应参数加上标记注解：

@ValidDaysPeriod
@GetMapping(produces = MediaType.APPLICATION_JSON_VALUE)
public MyData getMyData(@Nullable @PeriodId String id,
                        @NotNull @PeriodDays Integer periodDays) {
    // ...
}

3. 修改Validator逻辑，通过反射获取方法参数的注解来匹配对应值：

@SupportedValidationTarget(ValidationTarget.PARAMETERS)
public class DaysPeriodValidator implements ConstraintValidator<ValidDaysPeriod, Object[]> {

    private Method targetMethod;

    @Override
    public void initialize(ValidDaysPeriod constraintAnnotation) {
        // 从校验上下文获取当前被校验的方法
        MethodValidationContext validationContext = (MethodValidationContext) ConstraintValidatorContext.unwrap(context);
        this.targetMethod = validationContext.getMethod();
    }

    @Override
    public boolean isValid(Object[] objects, ConstraintValidatorContext context) {
        Integer periodDays = null;
        String id = null;

        Parameter[] parameters = targetMethod.getParameters();
        for (int i = 0; i < parameters.length; i++) {
            if (parameters[i].isAnnotationPresent(PeriodId.class)) {
                id = (String) objects[i];
            } else if (parameters[i].isAnnotationPresent(PeriodDays.class)) {
                periodDays = (Integer) objects[i];
            }
        }

        // 未找到目标参数直接返回校验失败
        if (id == null || periodDays == null) {
            return false;
        }

        // 执行自定义校验逻辑
        String validatedId = validateTenantId(id);
        // ... 后续校验步骤
        return valid;
    }
}

方案二：利用参数名称识别（需编译时配置） #

如果不想新增注解，可以通过反射获取参数真实名称，但需要满足编译条件：

• Java 8及以上版本，编译时添加-parameters参数，确保反射能拿到真实参数名（而非arg0、arg1这类占位符）。

修改Validator实现：

@SupportedValidationTarget(ValidationTarget.PARAMETERS)
public class DaysPeriodValidator implements ConstraintValidator<ValidDaysPeriod, Object[]> {

    private Method targetMethod;

    @Override
    public void initialize(ValidDaysPeriod constraintAnnotation) {
        MethodValidationContext validationContext = (MethodValidationContext) ConstraintValidatorContext.unwrap(context);
        this.targetMethod = validationContext.getMethod();
    }

    @Override
    public boolean isValid(Object[] objects, ConstraintValidatorContext context) {
        Integer periodDays = null;
        String id = null;

        Parameter[] parameters = targetMethod.getParameters();
        for (int i = 0; i < parameters.length; i++) {
            String paramName = parameters[i].getName();
            if ("id".equals(paramName)) {
                id = (String) objects[i];
            } else if ("periodDays".equals(paramName)) {
                periodDays = (Integer) objects[i];
            }
        }

        if (id == null || periodDays == null) {
            return false;
        }

        // 执行自定义校验逻辑
        String validatedId = validateTenantId(id);
        // ... 后续校验步骤
        return valid;
    }
}

注意：这种方式依赖参数的实际命名，若后续重构修改参数名，校验逻辑会失效，稳定性不如方案一。

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