Native模式下Java Validator无默认构造方法问题求助

问题背景 #

开发包含验证逻辑的应用时，编写了如下JSR-380验证器类：

@NoArgsConstructor
public class IsoCountryValidator implements ConstraintValidator<ValidIsoCountry, String> {

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return CountryUtil.isValidIsoAlpha2Code(value);
    }

}

并通过自定义注解在Mongo文档中使用：

@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = IsoCountryValidator.class)
public @interface ValidIsoCountry {

    String message() default "A country code must be a valid ISO-3166-1 alpha-2 code";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};

}

该验证逻辑在常规JVM模式下运行正常，但编译为GraalVM原生镜像后出现运行时错误。

运行时错误栈 #

java.lang.NoSuchMethodException: com.mypackage.validation.IsoCountryValidator.<init>()
        at java.base@21.0.2/java.lang.Class.checkMethod(DynamicHub.java:1075)
        at java.base@21.0.2/java.lang.Class.getConstructor0(DynamicHub.java:1238)
        at java.base@21.0.2/java.lang.Class.getDeclaredConstructor(DynamicHub.java:2930)
        at org.springframework.beans.factory.support.SimpleInstantiationStrategy.instantiate(SimpleInstantiationStrategy.java:80)
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.instantiateBean(AbstractAutowireCapableBeanFactory.java:1311)
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1202)
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:562)
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:522)
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:321)
        at org.springframework.validation.beanvalidation.SpringConstraintValidatorFactory.getInstance(SpringConstraintValidatorFactory.java:56)

已尝试的无效方案 #

• 手动添加reflect-config.json配置：

[
  {
    "name": "com.mypackage.validation.IsoCountryValidator",
    "allPublicMethods": true,
    "allDeclaredConstructors": true,
    "queryAllDeclaredConstructors" : true,
    "queryAllPublicConstructors" : true,
    "queryAllDeclaredMethods" : true,
    "queryAllPublicMethods" : true,
    "allDeclaredClasses" : true,
    "allPublicClasses" : true
  }
]

• 在Gradle的graalvmNative任务中添加初始化配置：

buildArgs.add('--initialize-at-run-time=com.mypackage.validation.IsoCountryValidator')

正确解决方案 #

1. 确保无参构造方法为public #

Lombok的@NoArgsConstructor默认生成包级私有的无参构造方法，JVM下Spring可以通过setAccessible(true)绕过访问限制，但GraalVM原生镜像中这种操作会被限制。需要显式指定构造方法的访问级别：

@NoArgsConstructor(access = AccessLevel.PUBLIC)
public class IsoCountryValidator implements ConstraintValidator<ValidIsoCountry, String> {
    // 原有逻辑不变
}

2. 精简并正确配置反射元数据 #

不需要冗余的反射配置，只需要明确声明验证器的无参构造方法和isValid方法可被反射访问，修改reflect-config.json为：

[
  {
    "name": "com.mypackage.validation.IsoCountryValidator",
    "constructors": [
      {
        "name": "<init>",
        "parameterTypes": []
      }
    ],
    "methods": [
      {
        "name": "isValid",
        "parameterTypes": ["java.lang.String", "javax.validation.ConstraintValidatorContext"]
      }
    ]
  }
]

3. 利用Spring Native自动配置（推荐） #

如果使用Spring Boot 3+（自带原生镜像支持），可以直接在验证器类或配置类上添加@RegisterReflectionForBinding注解，自动生成所需的反射元数据，无需手动维护reflect-config.json：

@RegisterReflectionForBinding(IsoCountryValidator.class)
@NoArgsConstructor(access = AccessLevel.PUBLIC)
public class IsoCountryValidator implements ConstraintValidator<ValidIsoCountry, String> {
    // 原有逻辑不变
}

原因说明 #

GraalVM原生镜像采用静态分析提前编译代码，未被显式标记为可反射访问的构造方法、字段和方法会被优化移除。同时，原生镜像严格限制了对非public成员的反射访问，即使JVM下可以通过setAccessible绕过，原生镜像中也会抛出异常。

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