WildFly 28.0.1.Final部署WAR失败：NullPointerException排查求助

针对你部署WildFly 28.0.1.Final时遇到的NullPointerException及部署失败问题，按以下步骤逐一排查：

1. 盯紧依赖注入的核心问题 #

• 检查HelloServlet里注入SentenceRepository的写法：如果用的是@Inject，那SentenceRepository必须是CDI托管的Bean——给它加上@ApplicationScoped或@Repository注解，让WildFly能识别并实例化它；
• 翻错误日志的堆栈信息，准确定位NPE发生的代码行：是SentenceRepository本身为null？还是它内部的EntityManager为null？这直接决定下一步排查方向。

2. 核对persistence.xml的关键配置 #

• 确保文件放在src/main/resources/META-INF/目录下，persistence-unit的配置要和WildFly环境匹配：
  • 数据源JNDI名必须和你在WildFly中配置的MySQL数据源完全一致（比如java:jboss/datasources/MySQLDS）；
  • 方言必须指定MySQL 8.x版本对应的：<property name="hibernate.dialect" value="org.hibernate.dialect.MySQL8Dialect"/>；
  • 事务类型设为JTA：<persistence-unit name="YourPU" transaction-type="JTA">；
  • 要么用<class>标签显式指定Sentence实体类，要么添加<exclude-unlisted-classes>false</exclude-unlisted-classes>让容器自动扫描实体类。

3. 确认WildFly的MySQL驱动配置 #

WildFly 28默认不带MySQL 8.x驱动，必须手动添加：

• 最简单的方式是通过WildFly管理控制台（http://localhost:9990）上传mysql-connector-java-8.0.33.jar并添加驱动；
• 也可以手动放置jar包到WILDFLY_HOME/modules/system/layers/base/com/mysql/main/，同时在该目录创建module.xml：

  <?xml version="1.0" encoding="UTF-8"?>
  <module xmlns="urn:jboss:module:1.9" name="com.mysql">
      <resources>
          <resource-root path="mysql-connector-java-8.0.33.jar"/>
      </resources>
      <dependencies>
          <module name="javax.api"/>
          <module name="javax.transaction.api"/>
      </dependencies>
  </module>
  

• 数据源配置里要指定driver-name=mysql，和驱动模块名对应上。

4. 检查beans.xml的位置和配置 #

• Web项目的beans.xml必须放在src/main/webapp/WEB-INF/，JAR类库的beans.xml放在src/main/resources/META-INF/；
• 配置要开启全量Bean扫描，避免遗漏托管类：

  <?xml version="1.0" encoding="UTF-8"?>
  <beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/beans_2_0.xsd"
         version="2.0" bean-discovery-mode="all">
  </beans>
  

  WildFly 28默认使用CDI Lite模式，bean-discovery-mode="all"能确保所有带注解的类都被容器扫描到。

5. 修正pom.xml的依赖范围 #

Java EE相关依赖必须设为provided，因为WildFly已经自带这些类库，避免打包后版本冲突：

<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
    <version>5.0.0</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>jakarta.persistence</groupId>
    <artifactId>jakarta.persistence-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>

不要把Hibernate、Servlet API这类依赖打包到war包中，否则会和WildFly自带版本冲突导致异常。

6. 精准定位NPE根源 #

从错误日志里找到完整的堆栈跟踪，比如：

Caused by: java.lang.NullPointerException
at com.example.HelloServlet.doGet(HelloServlet.java:25)
如果是这种情况，说明HelloServlet里的SentenceRepository未被成功注入，回到第一步检查CDI注解；如果是SentenceRepository调用EntityManager时抛出NPE，则重点排查persistence.xml和数据源配置。

内容的提问来源于stack exchange，提问作者Vinícius do Carmo Melício