Spring Boot+Scala REST API部署Wildfly10.0报错：无法实例化WebApplicationInitializer类

我来帮你排查这个部署问题！你遇到的Failed to instantiate WebApplicationInitializer class错误，通常是Spring Boot与Wildfly的依赖冲突、类加载限制或者版本兼容性导致的，下面是一步步的解决思路：

一、先处理依赖冲突问题 #

Wildfly 10自带了Servlet 3.1容器，而Spring Boot的War打包默认会引入Tomcat相关依赖，这很容易引发冲突。

1. 排除Spring Boot Starter Web中的Tomcat依赖
   修改你的pom.xml，移除自带的Tomcat容器依赖：

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-web</artifactId>
       <exclusions>
           <exclusion>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-tomcat</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   

2. 将Servlet API设置为provided scope
   让Wildfly提供Servlet API，避免打包到War中：

   <dependency>
       <groupId>javax.servlet</groupId>
       <artifactId>javax.servlet-api</artifactId>
       <version>3.1.0</version>
       <scope>provided</scope>
   </dependency>
   

二、检查Scala类的访问权限 #

Wildfly的类加载器对Scala编译后的类可能有反射限制，导致无法实例化WebApplicationInitializer实现类：

1. 确保Spring Boot启动类是public且有默认构造函数
   你的启动类应该继承SpringBootServletInitializer，并且是public访问级别：

   @SpringBootApplication
   class MyApplication extends SpringBootServletInitializer {
     override protected def configure(application: SpringApplicationBuilder): SpringApplicationBuilder = {
       application.sources(classOf[MyApplication])
     }
   }
   
   object MyApplication extends App {
     SpringApplication.run(classOf[MyApplication], args)
   }
   

2. 配置Scala Maven插件确保编译正确
   确保pom.xml中的Scala插件配置正确，生成可被反射访问的类：

   <plugin>
       <groupId>net.alchim31.maven</groupId>
       <artifactId>scala-maven-plugin</artifactId>
       <version>4.5.6</version>
       <executions>
           <execution>
               <goals>
                   <goal>compile</goal>
                   <goal>testCompile</goal>
               </goals>
               <configuration>
                   <args>
                       <arg>-dependencyfile</arg>
                       <arg>${project.build.directory}/.scala_dependencies</arg>
                   </args>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

三、添加Wildfly部署配置 #

Wildfly需要明确的模块依赖配置来支持Spring Boot应用：

在src/main/webapp/WEB-INF目录下创建jboss-deployment-structure.xml文件，添加必要的依赖：

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="javax.api"/>
            <module name="javax.servlet.api"/>
            <module name="javax.transaction.api"/>
        </dependencies>
        <exclude-subsystems>
            <!-- 如果你的项目不需要JPA，可以排除该子系统避免冲突 -->
            <subsystem name="jpa"/>
        </exclude-subsystems>
    </deployment>
</jboss-deployment-structure>

四、验证Spring Boot版本兼容性 #

Wildfly 10是比较老的版本（2016年发布），较新的Spring Boot版本可能存在兼容性问题，建议使用Spring Boot 1.5.x系列（长期支持版本，完美兼容Servlet 3.1）：

修改pom.xml中的parent依赖版本：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.5.22.RELEASE</version>
    <relativePath/>
</parent>

额外排查技巧 #

• 查看Wildfly的standalone/log/server.log日志，找到完整的错误堆栈，通常会明确指出是哪个类无法实例化，以及具体原因（比如ClassNotFoundException或NoSuchMethodException）。
• 解压War包检查结构，确保WEB-INF/classes下包含所有编译后的Scala类，WEB-INF/lib中没有重复或冲突的依赖。

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