如何用@Reflective注解为OpenAPI生成类生成Spring Native原生提示？

核心结论 #

@Reflective注解是给Spring Boot AOT处理器用的，不是给GraalVM的native-image-agent用的。执行mvn clean package -Pnative spring-boot:build-image时，Spring Boot会自动识别该注解并生成对应的反射配置，无需手动维护reflect-config.json，也不需要依赖native-image-agent的输出。

为什么你的测试没生成对应配置？ #

你用native-image-agent生成reflect-config.json的流程里，agent只会记录运行时实际触发的反射调用，不会读取@Reflective这类静态注解。如果你的冒烟测试没有触发这些POJO的反射操作（比如序列化/反序列化、反射实例化等），agent自然不会把这些类加入配置，这是正常现象。

正确的操作流程 #

1. 保持OpenAPI Generator的配置不变，确保所有POJO已添加@org.springframework.aot.hint.annotation.Reflective注解
2. 直接执行原生镜像构建命令：

   mvn clean package -Pnative spring-boot:build-image
   

   该命令会自动触发Spring Boot的AOT处理：
   • 编译阶段，Spring AOT处理器会扫描所有带@Reflective的类，生成对应的反射提示代码
   • 最终构建原生镜像时，这些提示会被转换成GraalVM需要的配置，无需手动编写reflect-config.json

验证注解是否生效的方法 #

可以检查target/generated-sources/aot目录下生成的代码，会有类似*ReflectionHints.java的文件，里面应该包含你标记了@Reflective的POJO类，证明AOT处理器已识别到注解。

额外说明 #

• 如果你之前手动维护的reflect-config.json还存在，Spring Boot会合并AOT生成的配置和手动配置，不会冲突
• 确保使用的Spring Boot版本为3.x及以上（Spring Native已正式整合到Spring Boot 3+，旧版本不支持@Reflective注解的自动处理）

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