GraalVM Native Image打包Qpid AMQPS客户端报Provider scheme NOT recognized错误求助

问题根因 #

你遇到的报错是GraalVM原生镜像编译的典型问题：
Apache Qpid JMS客户端使用Java SPI（服务提供接口）机制加载对应协议的Provider实现，amqps协议的工厂配置放在META-INF/services/org/apache/qpid/jms/provider/amqps路径下。JVM运行时会自动扫描加载该配置，但GraalVM native-image默认不会把未显式声明的SPI配置、动态加载资源打包进原生镜像，因此编译后运行时找不到对应协议的Provider实现，抛出scheme不识别的错误。

解决步骤 #

方案1：使用GraalVM Tracing Agent自动生成配置（推荐，不易遗漏） #

这是最稳妥的方案，避免手动配置漏项：

1. 先在普通JVM模式下运行你的测试程序，启动时添加GraalVM追踪Agent参数：

java -agentlib:native-image-agent=config-output-dir=./src/main/resources/META-INF/native-image/ 你的主类全限定名

2. 运行过程中完整走一遍AMQPS连接、消息收发的全流程，Agent会自动把用到的反射类、资源文件、SPI配置都生成到指定目录下，包含：

• reflect-config.json（反射配置）
• resource-config.json（资源文件配置）
• jni-config.json（JNI配置，如有需要）
• proxy-config.json（代理类配置，如有需要）

3. 重新执行native-image编译，工具会自动读取上述目录下的配置，将Qpid所需的SPI资源和类都纳入原生镜像。

方案2：手动添加配置（适合快速POC） #

如果不想跑Agent，可手动添加如下配置：

1. 新增资源配置文件src/main/resources/META-INF/native-image/resource-config.json，内容如下：

{
  "resources": {
    "includes": [
      {"pattern": "META-INF/services/org/apache/qpid/jms/provider/.*"},
      {"pattern": "META-INF/services/org/apache/qpid/jms/.*"},
      {"pattern": "qpid-jms.properties"}
    ]
  },
  "bundles": []
}

2. 新增SPI注册配置，在native-image编译参数中添加：

-H:ServiceLoaderResourceProviders=org.apache.qpid.jms.provider.ProviderFactory

3. 额外适配注意事项：

• 你的运行环境是Windows，系统不支持Epoll和KQueue，建议先将连接URI中的transport.useEpoll=true&transport.useKQueue=true改为false，避免额外的本地库加载报错。
• 编译时添加SSL相关参数：--enable-https，确保TLS相关类被纳入镜像。

方案3：硬编码绕过SPI加载（最快POC方案） #

可以直接在代码中指定Provider实现，跳过SPI查找逻辑，无需额外配置：

// 手动实例化AMQP Provider工厂，绕过SPI查找
JmsConnectionFactory factory = new JmsConnectionFactory(yourAmqpsUri);
factory.setProviderFactory(new org.apache.qpid.jms.provider.amqp.AmqpProviderFactory());

验证方法 #

编译后直接运行原生可执行文件，正常情况下可以成功建立AMQPS连接，无scheme不识别报错。

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