Tomcat 10迁移遇logback-logstash-encoder加载Jackson模块错误求助

核心原因 #

这个错误是类加载器隔离导致的Jackson类型不匹配：独立Tomcat 10的类加载器机制与Spring Boot内嵌Tomcat不同，Tomcat自身可能携带了旧版本Jackson类库，或者应用类加载器与Tomcat的公共类加载器加载了不同版本的com.fasterxml.jackson.databind.Module类，导致Jdk8Module被识别为非子类型。

解决步骤 #

• 清理Tomcat自带Jackson依赖：检查Tomcat安装目录下的lib文件夹，若存在jackson-*相关jar包，直接删除或替换为你项目中使用的2.15.1版本。
• 调整类加载优先级：在Tomcat的conf/context.xml文件中，给<Context>标签添加配置，让应用WEB-INF/lib中的类优先加载：

  <Context>
    <Loader delegate="false"/>
    <!-- 其他原有配置 -->
  </Context>
  

• 排查项目依赖冲突：用构建工具命令排查重复依赖：
  • Maven：执行mvn dependency:tree，搜索jackson相关依赖，排除所有版本不一致的子依赖。
  • Gradle：执行gradle dependencies，同样排查并排除冲突依赖。
• 显式注册Jackson模块：绕过ServiceLoader自动加载机制，在logback.xml的LoggingEventCompositeJsonEncoder中手动指定需要的模块：

  <encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder">
    <providers>
      <!-- 保留你原有的provider配置，比如timestamp、message等 -->
      <stackTrace/>
    </providers>
    <jacksonModules>
      <module class="com.fasterxml.jackson.datatype.jdk8.Jdk8Module"/>
      <module class="com.fasterxml.jackson.datatype.jsr310.JavaTimeModule"/>
      <!-- 根据需求添加其他Jackson模块 -->
    </jacksonModules>
  </encoder>
  

内容的提问来源于stack exchange，提问作者Mançaux Pierre-Alexandre