Spring Integration Handler报NoClassDefFoundError：ClassUtils初始化排查

场景复现 #

基于Spring 5的应用以*.war包形式部署至Tomcat 9，依赖org.springframework.integration:spring-integration-jms:5.4.13，包含如下RestController端点：

@RestController
class MyController {

    private final MessageChannel channel;

    public IntegrationChannelDataloadingResource(MessageChannel myChannel){
        this.channel = channel;
    }

    @GetMapping("/send-message")
    public void sendMessage(){
        Message m = Helper.createDummyMessage();

        channel.send(m);
    }
}

调用/send-message端点时，触发NoClassDefFoundError，堆栈信息如下：

Caused by: java.lang.NoClassDefFoundError: Could not initialize class org.springframework.integration.util.ClassUtils
  at org.springframework.integration.handler.support.MessagingMethodInvokerHelper$HandlerMethod.invoke(MessagingMethodInvokerHelper.java:1107)
  at org.springframework.integration.handler.support.MessagingMethodInvokerHelper.invokeHandlerMethod(MessagingMethodInvokerHelper.java:583)
  at org.springframework.integration.handler.support.MessagingMethodInvokerHelper.processInternal(MessagingMethodInvokerHelper.java:478)
  at org.springframework.integration.handler.support.MessagingMethodInvokerHelper.process(MessagingMethodInvokerHelper.java:356)
  at org.springframework.integration.handler.MethodInvokingMessageProcessor.processMessage(MethodInvokingMessageProcessor.java:108)
  at org.springframework.integration.transformer.AbstractMessageProcessingTransformer.transform(AbstractMessageProcessingTransformer.java:115)
  at org.springframework.integration.transformer.MessageTransformingHandler.handleRequestMessage(MessageTransformingHandler.java:119)
  at org.springframework.integration.handler.AbstractReplyProducingMessageHandler.handleMessageInternal(AbstractReplyProducingMessageHandler.java:134)
  at org.springframework.integration.handler.AbstractMessageHandler.handleMessage(AbstractMessageHandler.java:56)
  at org.springframework.integration.dispatcher.AbstractDispatcher.tryOptimizedDispatch(AbstractDispatcher.java:115)
  at org.springframework.integration.dispatcher.UnicastingDispatcher.doDispatch(UnicastingDispatcher.java:133)
  at org.springframework.integration.dispatcher.UnicastingDispatcher.dispatch(UnicastingDispatcher.java:106)
  at org.springframework.integration.channel.AbstractSubscribableChannel.doSend(AbstractSubscribableChannel.java:72)
  at org.springframework.integration.channel.AbstractMessageChannel.send(AbstractMessageChannel.java:317)
  at org.springframework.integration.channel.AbstractMessageChannel.send(AbstractMessageChannel.java:272)
  at app.domain.resources.MyController.sendMessage(....)

已确认org.springframework.integration.util.ClassUtils存在于类路径中，推测是其静态初始化块执行失败，但无明确日志证据。

一、静态初始化失败的常见原因 #

• 依赖类缺失/初始化失败：ClassUtils的静态初始化块可能依赖其他Spring Integration核心类或Spring基础类，若这些类缺失或自身初始化失败，会导致ClassUtils初始化终止，抛出NoClassDefFoundError。
• 类加载器冲突：Tomcat的类加载器层级（Common/Webapp）可能存在版本冲突，比如Webapp内的Spring类与Tomcat全局类库中的Spring类版本不一致，导致加载了错误版本的类，触发初始化失败。
• 运行权限不足：Tomcat运行时缺少读取资源文件的权限（比如ClassUtils静态块依赖的配置文件、属性文件），未捕获的IO异常会导致类初始化失败。
• 静态变量初始化错误：ClassUtils中的静态变量初始化逻辑出错（如计算错误、依赖外部资源不可用），未捕获的异常会直接导致类初始化失败。

二、缺失依赖排查 #

• 确认Spring Integration核心依赖：spring-integration-jms依赖spring-integration-core，需确保引入了与JMS模块同版本（5.4.13）的核心模块，避免传递依赖缺失。
• 检查Spring核心版本兼容性：Spring Integration 5.4.x需要搭配Spring 5.2.x及以上版本，若Spring核心版本过低或过高，会引发类兼容问题，导致初始化失败。
• 补全JMS客户端依赖：如果使用特定JMS实现（如ActiveMQ、RabbitMQ JMS客户端），需确认对应客户端依赖是否齐全、版本兼容，缺失依赖可能间接触发ClassUtils初始化失败。
• 排查依赖冲突：用Maven/Gradle的依赖分析工具（如mvn dependency:tree）检查是否存在版本冲突的依赖，比如不同版本的Spring类共存，导致加载错误版本的类。

三、调试建议 #

• 开启类加载日志：在Tomcat启动参数中添加-verbose:class，查看ClassUtils及其依赖类的加载路径，确认是否加载了正确版本的类。
• 提高日志级别：将Spring相关日志级别调整为DEBUG，类初始化时的异常可能会被DEBUG日志捕获，帮助定位具体错误。
• 手动触发初始化并捕获异常：在Controller中提前调用ClassUtils的静态方法，并用try-catch捕获ExceptionInInitializerError，直接获取初始化失败的具体异常信息。

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