集成Log4j2后Spring Boot多模块应用抛出NoClassDefFoundError异常

问题根源 #

org.springframework.core.NestedIOException属于spring-core模块，出现该错误的核心原因是该类未在应用类路径中，通常由以下情况导致：

• 依赖冲突或版本不兼容：Spring Boot版本与spring-core版本不匹配
• 错误的Log4j2集成方式：未使用官方提供的starter依赖，导致缺失必要的桥接或传递依赖
• 多模块下依赖传递异常：子模块未正确继承父POM的依赖配置

解决方案步骤 #

1. 修正父POM的Log4j2集成配置

不要手动单独引入log4j-core等依赖，直接使用Spring Boot官方的spring-boot-starter-log4j2，它会自动管理所有必要依赖（包括spring-core的正确版本），同时自动适配多模块的依赖传递。

示例父POM配置：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>你的Spring Boot版本（如2.7.15）</version>
    <relativePath/>
</parent>

<dependencies>
    <!-- 基础Web依赖，排除默认logging -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <exclusions>
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    
    <!-- 引入Log4j2官方starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
    </dependency>
</dependencies>

2. 检查多模块依赖一致性

• 确保所有子模块的POM都正确继承父POM，避免重复引入或排除依赖
• 执行以下命令检查spring-core的依赖情况，确认版本统一且存在：

mvn dependency:tree -Dincludes=org.springframework:spring-core

如果输出中无spring-core或版本与父POM不一致，需排查子模块是否覆盖了依赖版本，或意外排除了spring-core。

3. 验证Log4j2配置文件

• 确保log4j2.xml放在src/main/resources目录下，Spring Boot启动时能自动加载
• 检查配置文件语法是否正确，比如标签闭合、格式规范，避免因配置加载失败间接引发类加载异常

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