Quarkus中@RegisterForReflection的适用场景及无需使用的原因

为什么你的PoC场景无需使用@RegisterForReflection #

你的项目在未添加该注解的情况下，dev和native模式反序列化均正常，主要有以下几个原因：

• Rest Client Jackson扩展的自动扫描机制：quarkus-rest-client-jackson扩展会自动识别被@RegisterRestClient接口直接引用的DTO类（比如作为返回值类型），并将这些类自动纳入native编译所需的反射元数据中，无需手动添加注解。
• 类结构符合Quarkus字节码增强规则：如果你的DTO是public访问权限，且拥有标准的getter/setter方法（或使用Lombok的@Data等注解生成这些方法），Quarkus的字节码增强工具会自动保留这些类在native模式下反序列化所需的反射信息。
• 新版本Quarkus的优化：较新的Quarkus版本对反射元数据的自动收集逻辑做了优化，进一步减少了手动添加@RegisterForReflection的场景。

何时必须使用@RegisterForReflection #

在以下场景中，你必须手动添加该注解才能保证native模式正常运行：

• 间接引用的类或泛型嵌套类型：如果DTO是嵌套在其他类中的泛型类型，或是通过Jackson多态反序列化（如@JsonTypeInfo注解）涉及的子类，Quarkus的自动扫描机制可能无法识别这些类，需要手动注册。
• 手动使用ObjectMapper反序列化：当你绕过Rest Client，直接使用Jackson的ObjectMapper进行反序列化，且目标类未被Quarkus扩展自动检测到时（比如动态加载的类、运行时才确定的类型），需要手动注册反射。
• 第三方库依赖反射处理你的类：如果你的类被某些第三方库通过反射调用，而这些类不在Quarkus自动扫描的范围内，必须手动添加注解。
• 关闭自动反射收集：若你通过配置quarkus.reflection.auto=false关闭了Quarkus的自动反射收集功能，所有需要反射支持的类都必须手动添加@RegisterForReflection。

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