Jackson2.12.2生成YAML时运行报NoClassDefFoundError问题排查

问题产生的直接诱因 #

• 类路径版本不匹配：本次异常的直接触发原因是，2.12.2版本的jackson-databind在初始化时，需要引用2.10+版本jackson-core中才有的com.fasterxml.jackson.core.util.JacksonFeature类，但类路径下实际加载的jackson-core是2.8.11旧版本，包内不存在该类，因此抛出NoClassDefFoundError。
• 依赖被覆盖的原因：Maven的默认仲裁规则生效，从你提供的依赖树可以看到，最终生效的jackson-dataformat-yaml是2.8.11版本，连带传递引入同版本的jackson-core，你原本在POM中声明的2.12.2版本YAML依赖没有被最终采用，通常由两种场景导致：
  • 你POM中的feign-httpclient依赖声明在自定义Jackson依赖之前，触发了Maven“同依赖先声明优先”的仲裁逻辑
  • 项目的父POM、全局dependencyManagement配置中，硬编码了Jackson相关组件的版本为2.8.11，直接覆盖了你自定义的版本声明
• 编译正常但运行报错的原因：编译阶段Maven按照你声明的依赖版本配置编译类路径，你的业务代码没有调用旧版本不存在的类，因此可以正常编译；但运行时类加载会优先加载仲裁后生效的旧版依赖包，就会触发类找不到的运行时异常。

同类运行时依赖缺失问题的通用排查方法 #

• 先从异常栈提取缺失类的全限定名，反查该类所属的组件、最低兼容版本，缩小问题排查范围。
• 执行mvn dependency:tree -Dverbose命令，开启 verbose 模式可以看到所有被仲裁、被覆盖的依赖全路径。普通模式下的依赖树只会展示最终生效的版本，不会展示被替换掉的条目，无法定位自定义版本失效的原因。
• 针对版本错配问题，可按优先级选择解决方案：
  • 在POM的<dependencies>节点下，直接手动声明所有关联的Jackson组件（jackson-core、jackson-annotations、jackson-databind、jackson-dataformat-yaml）为统一的目标版本，直接声明的依赖优先级永远高于传递依赖
  • 找到引入旧版依赖的上游组件（本次为feign-httpclient），在其依赖配置中添加<exclusions>标签，排除它传递引入的所有旧版Jackson依赖
  • 在项目的dependencyManagement节点中，统一锁定所有Jackson组件的版本为目标版本，强制覆盖所有传递依赖的版本
• 最终验证类路径正确性：执行mvn dependency:build-classpath命令输出生效的类路径，逐一对标依赖版本，确保没有错配的包版本。

注意：Jackson生态的core、databind、数据格式类组件是强版本绑定的，所有组件必须保持版本完全一致，否则极易出现类找不到、方法签名不匹配的运行时错误。由于你团队处于隔离内网环境，确认所需的具体版本后，直接将对应版本的二进制包上传到内部Nexus即可，不要随意替换为其他邻近版本。

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