升级Camel 2.X至3.X时遭遇org.jboss.jandex.UnsupportedVersion异常求助

1. 是否存在不含Jandex的Camel版本？ #

Camel 3.X系列默认会在jar包中附带jandex.idx索引文件，官方没有提供完全移除Jandex的发行版本。但可以通过两种方式实现无Jandex的Camel包：

• 构建阶段禁用：如果使用Maven构建项目，可在pom.xml中配置禁用jandex-maven-plugin的执行，阻止生成Jandex索引；
• 手动修改现有包：解压Camel的jar包，删除META-INF/jandex.idx文件后重新打包，这属于临时 workaround，不推荐长期使用。

2. 能否抑制或停用Jandex？ #

可以通过WildFly的配置来抑制Jandex索引加载，有几种方式可选：

• 单应用配置：在EAR/WAR包的jboss-deployment-structure.xml中添加如下配置，排除对Camel jar包的Jandex扫描：

  <jboss-deployment-structure>
      <deployment>
          <exclusions>
              <module name="org.jboss.jandex" />
          </exclusions>
          <dependencies>
              <module name="org.jboss.jandex" optional="true" />
          </dependencies>
      </deployment>
  </jboss-deployment-structure>
  

• 全局跳过：启动WildFly时添加JVM参数-Djboss.jandex.skip=true，直接跳过所有Jandex索引的加载，但这可能影响其他依赖注解扫描的应用性能；
• 全局配置调整：修改WildFly的standalone.xml或domain.xml，调整注解索引的扫描规则，这种方式会影响所有部署的应用，需谨慎操作。

3. 更换为更新版本的WildFly解决问题，是否会产生冲突？ #

大概率不会产生冲突，但需注意以下几点：

• WildFly新版本通常会升级自带的Jandex库，比如WildFly 20及以上版本的Jandex已支持版本10的索引格式，可直接解决当前的UnsupportedVersion错误；
• 需确认Camel 3.X与目标WildFly版本的兼容性：Camel 3.14.x推荐搭配WildFly 21-26版本，避免跨版本过大导致的API不兼容；
• 检查应用中其他依赖（如旧JDBC驱动、自定义模块）是否适配新版本WildFly，必要时同步升级。

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