Log4j切换至JsonLayout出现NoClassDefFoundError问题咨询

核心原因：Log4j Core的Jackson依赖是可选依赖 #

把log4j-core和log4j-jcl设为runtimeOnly本身不会直接触发这个错误，但Log4j Core 2.x对Jackson的依赖是标记为「可选（optional）」的——这意味着Gradle不会自动将Jackson相关依赖（包括你缺失的jackson-databind）传递到项目中。不管log4j-core用implementation还是runtimeOnly，只要切换到需要Jackson支持的JsonLayout，就必须手动添加Jackson依赖。

解决步骤 #

1. 确认依赖缺失：执行gradle dependencies查看项目依赖树，你会发现jackson-databind并未被引入，因为它是log4j-core的可选依赖，不会自动传递。
2. 手动添加Jackson依赖：在Gradle配置中添加兼容版本的Jackson依赖（你提到的2.13.1与log4j-core 2.17.2匹配）：

runtimeOnly('com.fasterxml.jackson.core:jackson-databind:2.13.1')
runtimeOnly('com.fasterxml.jackson.core:jackson-core:2.13.1')
runtimeOnly('com.fasterxml.jackson.core:jackson-annotations:2.13.1')

如果你的项目在编译阶段也需要Jackson（比如自定义JSON序列化逻辑），可以把runtimeOnly替换为implementation。

补充说明runtimeOnly的影响 #

runtimeOnly的作用是让依赖仅在运行时可用，编译阶段不会加入类路径。但这个scope不影响可选依赖的传递逻辑——可选依赖本身就不会自动被引入，和log4j-core的scope无关。之前用PatternLayout没问题，是因为PatternLayout不需要Jackson支持，而JsonLayout的初始化必须依赖Jackson类，所以才会触发NoClassDefFoundError。

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