Wildfly部署含多应用的EAR时Spring Boot WAR报NoClassDefFoundError

问题本质 #

单独部署WAR正常，打包进EAR并包含其他模块时出现类找不到错误，核心是EAR类加载器的隔离/冲突问题：Wildfly为EAR创建的类加载上下文会共享模块依赖，导致Spring Web核心类的加载路径被干扰，无法被Spring Boot的自动配置类（如ErrorMvcAutoConfiguration）找到。

具体解决方案 #

1. 修正Spring Boot WAR的依赖范围 #

确保spring-boot-starter-web及其依赖（包括spring-webmvc）是compile scope，不要标记为provided——Wildfly 23自带的Spring版本与Boot 2.7.x不兼容，必须将Spring Boot的依赖打包进WAR的WEB-INF/lib目录。

• 检查pom.xml，避免如下错误配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <scope>provided</scope> <!-- 此配置会导致依赖不打包，EAR部署时缺失类 -->
</dependency>

2. 配置类加载隔离规则 #

在WAR的WEB-INF目录下创建jboss-deployment-structure.xml，强制WAR使用独立类加载器，排除Wildfly自带的Spring子系统和模块，避免冲突：

<jboss-deployment-structure>
    <deployment>
        <exclude-subsystems>
            <subsystem name="spring"/> <!-- 禁用容器自带的Spring子系统 -->
        </exclude-subsystems>
        <exclusions>
            <module name="org.springframework"/> <!-- 排除容器提供的Spring模块 -->
        </exclusions>
        <local-last value="true"/> <!-- 优先加载WAR内部的类，再加载容器类 -->
    </deployment>
</jboss-deployment-structure>

若需要全局配置，可在EAR的META-INF目录下创建该文件，指定各模块的类加载策略。

3. 排查EAR内模块的依赖冲突 #

使用mvn dependency:tree分析EAR中所有模块的依赖树，查找是否存在低版本或不兼容的Spring依赖（比如其他模块依赖Spring 4.x），这类冲突会导致类加载器加载错误版本的类，进而引发找不到类的问题。

• 对于冲突模块，通过<exclusion>排除旧版本Spring依赖：

<dependency>
    <groupId>第三方模块groupId</groupId>
    <artifactId>第三方模块artifactId</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
        </exclusion>
    </exclusions>
</dependency>

4. 确保Spring Boot WAR打包配置正确 #

插件配置

pom.xml中需正确配置spring-boot-maven-plugin和maven-war-plugin，确保生成适配Wildfly的WAR包：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <war>
                    <excludedDevtools>true</excludedDevtools>
                </war>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <configuration>
                <failOnMissingWebXml>false</failOnMissingWebXml>
            </configuration>
        </plugin>
    </plugins>
</build>

启动类配置

Spring Boot启动类必须继承SpringBootServletInitializer，适配Servlet容器部署：

@SpringBootApplication
public class DemoApplication extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(DemoApplication.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

5. 检查Wildfly自带模块 #

查看Wildfly安装目录下modules/system/layers/base/org/springframework，确认没有自定义添加的不兼容Spring模块。若存在，暂时移除或替换为Spring 5.3.x版本（与Boot 2.7.x兼容）。

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