Quarkus native编译后无法读取Cucumber步骤注解value值如何解决

根因分析 #

核心问题是GraalVM原生镜像编译时默认会擦除未明确标记保留的注解元数据，同时Cucumber的GlueAdaptor中通过annotation.getClass().getMethod("value")取动态代理类方法的写法，在原生环境下缺少对应的代理方法元数据，所以抛出NoSuchMethodException，同时注解属性值被擦除导致打印时无value。

你之前尝试的方案未生效，是因为缺少了注解类型的专属反射标记，以及动态代理和反射配置未配套。 #

可行解决方案 #

按优先级从高到低尝试：

方案1：修改GlueAdaptor实现（最稳妥，无额外配置依赖） #

直接修改报错的代码段，绕过动态代理类取方法的逻辑：

// 原有报错代码
// Method expressionMethod = annotation.getClass().getMethod("value");
// 替换为以下代码
Class<? extends Annotation> annotationType = annotation.annotationType();
Method expressionMethod = annotationType.getMethod("value");
// 后续取值逻辑不变，直接用expressionMethod.invoke(annotation)拿value

annotation.annotationType()返回的是原始的注解接口类（比如Given.class），而非运行时生成的$$ProxyImpl代理类，原生环境下只要注解接口的反射元数据存在就能正常调用，无需额外适配代理类。

方案2：补全原生编译的反射、代理配置 #

如果无法修改Cucumber源码，就补全GraalVM需要的元数据配置：

1. 新建reflect-config.json放到src/main/resources/META-INF/native-image/目录下，内容如下：

[
  {
    "name": "io.cucumber.java.en.Given",
    "allPublicMethods": true,
    "allDeclaredMethods": true,
    "annotationType": true
  },
  {
    "name": "io.cucumber.java.en.When",
    "allPublicMethods": true,
    "allDeclaredMethods": true,
    "annotationType": true
  },
  {
    "name": "io.cucumber.java.en.Then",
    "allPublicMethods": true,
    "allDeclaredMethods": true,
    "annotationType": true
  },
  {
    "name": "io.cucumber.java.en.And",
    "allPublicMethods": true,
    "allDeclaredMethods": true,
    "annotationType": true
  },
  {
    "name": "io.cucumber.java.en.But",
    "allPublicMethods": true,
    "allDeclaredMethods": true,
    "annotationType": true
  },
  {
    "name": "io.cucumber.java.StepDefinitionAnnotation",
    "allPublicMethods": true,
    "allDeclaredMethods": true,
    "annotationType": true
  }
]

注意必须加"annotationType": true，该标记告诉GraalVM保留对应注解的所有元数据，包括属性值，这是你之前的配置缺失的核心项。

2. 新建proxy-config.json放到同一目录，内容如下：

[
  ["io.cucumber.java.en.Given"],
  ["io.cucumber.java.en.When"],
  ["io.cucumber.java.en.Then"],
  ["io.cucumber.java.en.And"],
  ["io.cucumber.java.en.But"],
  ["io.cucumber.java.StepDefinitionAnnotation"]
]

3. 在application.properties中添加配置指定编译参数：

quarkus.native.additional-build-args=\
-H:ReflectionConfigurationResources=META-INF/native-image/reflect-config.json,\
-H:DynamicProxyConfigurationResources=META-INF/native-image/proxy-config.json

配置完成后重新执行./mvnw package -Pnative编译即可。

方案3：通过Quarkus扩展BuildStep注册元数据 #

如果你使用自定义扩展的方式，修改BuildStep补全反射注册逻辑即可：

@BuildStep
void registerReflections(BuildProducer<ReflectionRegistrationBuildItem> reflections) {
    // 注册所有Cucumber步骤注解，指定annotationType为true
    reflections.produce(ReflectionRegistrationBuildItem.builder()
            .className(Given.class.getName())
            .methods(true)
            .annotationType(true)
            .build());
    reflections.produce(ReflectionRegistrationBuildItem.builder()
            .className(When.class.getName())
            .methods(true)
            .annotationType(true)
            .build());
    // 同理注册Then、And、But、StepDefinitionAnnotation
}

// 原有代理注册逻辑保留即可
@BuildStep
void addProxies(BuildProducer<NativeImageProxyDefinitionBuildItem> proxies) {
    proxies.produce(new NativeImageProxyDefinitionBuildItem(StepDefinitionAnnotation.class.getName()));
    proxies.produce(new NativeImageProxyDefinitionBuildItem(Given.class.getName()));
    proxies.produce(new NativeImageProxyDefinitionBuildItem(When.class.getName()));
    proxies.produce(new NativeImageProxyDefinitionBuildItem(Then.class.getName()));
    proxies.produce(new NativeImageProxyDefinitionBuildItem(And.class.getName()));
    proxies.produce(new NativeImageProxyDefinitionBuildItem(But.class.getName()));
}

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