如何针对原生构建测试Quarkus反射注册扩展？

一、直接测试原生可执行文件的方法 #

• 用Quarkus原生测试框架：在扩展的测试模块里，给测试类加上@NativeImageTest注解（JUnit 5环境），测试逻辑里直接调用JsonFormat.printer().print()验证反射注册是否生效。
• 自动构建测试用原生镜像：在扩展的pom.xml里配置quarkus.native.test.enabled=true，执行mvn verify时会自动构建原生镜像并运行测试用例。

二、解决你遇到的三个核心问题 #

1. 自动适配新增的Proto生成类 #

• 做个构建时扩展，在编译阶段扫描target/generated-sources/protobuf目录下的所有Proto生成类，自动收集类名并注册到反射配置，不用手动维护列表。
• 借助Quarkus的BuildStep机制，读取生成的Proto类字节码，提取类信息完成反射注册。

2. 处理protoc生成的嵌套类 #

• 扫描类的时候，递归遍历内部类（嵌套类），把所有嵌套类也加入反射注册列表。可以用Class.getDeclaredClasses()获取嵌套类，或者在字节码层面解析类结构。
• Quarkus反射注册API支持直接用全限定名注册嵌套类（比如com.example.MyOuter$MyNested），扫描时注意生成正确的类名格式。

3. 实现包级批量注册 #

• 在构建时扩展里指定目标包路径，遍历该包下所有Proto生成类（包括嵌套类），批量注册到反射配置。
• 用类路径扫描工具（比如Quarkus自带的扫描工具）扫指定包下的类，过滤出protoc生成的消息类（一般带@Generated注解，来源标注为protoc）。

三、测试示例代码 #

@NativeImageTest
public class ProtoReflectionExtensionNativeTest {

    @Test
    public void testProtoReflection() throws Exception {
        // 实例化Proto消息（包含嵌套类）
        MyProtoMessage testMsg = MyProtoMessage.newBuilder()
                .setId(1)
                .setNestedMsg(MyProtoMessage.NestedMsg.newBuilder().setContent("test").build())
                .build();
        
        // 调用JsonFormat验证反射是否正常工作
        String jsonResult = JsonFormat.printer().print(testMsg);
        assertNotNull(jsonResult);
        // 断言嵌套类字段被正确序列化
        assertTrue(jsonResult.contains("nestedMsg"));
        assertTrue(jsonResult.contains("content"));
    }
}

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