JBoss部署Elasticsearch客户端时遇Jackson isexpectednumberonytoken()错误排查

JBoss 是否支持 Jackson 2.17 版本？ #

JBoss（以主流的JBoss EAP为例）本身自带Jackson模块，不同版本的JBoss预装的Jackson版本不同：

• JBoss EAP 7.4 自带 Jackson 2.13.x
• JBoss EAP 8.0 自带 Jackson 2.15.x

不存在“官方支持Jackson 2.17”的说法，但可以通过类加载隔离让应用使用自己打包的Jackson 2.17版本。直接部署未做隔离配置的应用时，JBoss会优先加载自带的Jackson模块，导致应用打包的2.17版本无法生效，进而引发类版本冲突或方法缺失（比如你遇到的isExpectedNumberIntToken()方法问题，可能是因为JBoss自带的低版本Jackson没有该方法）。

进一步调试方案 #

1. 确认Jackson类的加载来源 #

• 开启JBoss类加载日志：在standalone.xml或domain.xml中，将日志类别org.jboss.as.server.deployment的级别设为DEBUG，启动JBoss后查看日志，找到Jackson相关类（如com.fasterxml.jackson.core.JsonParser）的加载路径，确认是来自JBoss模块还是应用的WEB-INF/lib。
• 使用JDK工具排查：执行jcmd <JBOSS进程ID> VM.classloader_stats，或用jmap -histo <PID> | grep jackson查看类的加载情况，判断是否存在类版本冲突。

2. 配置类加载隔离，强制使用应用自带的Jackson #

在应用WAR包的WEB-INF目录下创建jboss-deployment-structure.xml，添加以下配置排除JBoss自带的Jackson模块：

<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <module name="com.fasterxml.jackson.core.jackson-core"/>
            <module name="com.fasterxml.jackson.core.jackson-databind"/>
            <module name="com.fasterxml.jackson.core.jackson-annotations"/>
            <module name="com.fasterxml.jackson.jaxrs.jackson-jaxrs-json-provider"/>
            <module name="com.fasterxml.jackson.module.jackson-module-jaxb-annotations"/>
        </exclusions>
    </deployment>
</jboss-deployment-structure>

重新打包部署后，验证应用是否加载自己的Jackson 2.17版本。

3. 单独验证Inner Hits的JSON解析逻辑 #

• 捕获Elasticsearch返回的原始JSON响应（可以通过开启ES客户端的请求日志获取），将其保存为本地JSON文件。
• 编写独立的测试类，使用Jackson 2.17的ObjectMapper直接解析该JSON文件，看是否会触发相同错误。如果解析正常，说明问题源于JBoss的类加载冲突；如果仍报错，说明JSON结构中存在Jackson 2.17解析异常的节点，需要排查Inner Hits的返回结构。

4. 启用Jackson调试日志 #

在应用的日志配置（如log4j2.xml）中添加Jackson的DEBUG日志：

<Logger name="com.fasterxml.jackson" level="DEBUG" additivity="false">
    <AppenderRef ref="Console"/>
</Logger>

启动应用后，查看Jackson解析过程的详细日志，定位到触发isExpectedNumberIntToken()错误的具体JSON节点和解析步骤，进一步缩小问题范围。

5. 验证ES客户端与Jackson的兼容性 #

Elasticsearch Java客户端7.21.1对Jackson的依赖要求是2.13.x及以上，Jackson 2.17理论上兼容，但可以检查客户端依赖树是否存在冲突：执行mvn dependency:tree（如果用Maven）或gradle dependencies（如果用Gradle），确认是否有其他依赖引入了低版本Jackson，导致应用打包时混入冲突版本。

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