Spring Boot 3部署WildFly 31：Hibernate模块排除报错及正确实现方式

是否需要排除WildFly的Hibernate模块？ #

需要。尽管WildFly 31自带的Hibernate ORM版本（6.4.x）和Spring Boot 3.2.5依赖的Hibernate版本一致，但Spring Boot对Hibernate的整合逻辑是独立的，容器自带的Hibernate模块可能会干扰Spring Boot的JPA配置（比如容器试图接管EntityManagerFactory创建），进而引发类加载冲突或配置优先级问题，因此建议排除容器自带的Hibernate相关模块。

警告原因及正确排除方式 #

你看到的警告是因为WildFly 31中，Hibernate的核心模块名称已经从org.hibernate改为org.hibernate.orm，旧的org.hibernate模块已不再是容器默认依赖的有效模块，所以你配置的排除规则找不到目标模块。

正确的jboss-deployment-structure.xml配置应该排除org.hibernate.orm，同时建议一并排除JPA API相关模块，彻底隔离容器的JPA干预：

<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.0">
  <deployment>
    <exclusions>
       <!-- 排除WildFly自带的Hibernate ORM核心模块 -->
       <module name="org.hibernate.orm"/>
       <!-- 排除容器提供的JPA API，避免与Spring Boot自带的API冲突 -->
       <module name="jakarta.persistence.api"/>
    </exclusions>
  </deployment>
</jboss-deployment-structure>

额外部署注意事项 #

1. 打包配置调整：
   将Spring Boot项目打包为WAR包，并将内置Tomcat依赖设为provided，避免与WildFly的Servlet容器冲突：

   <!-- pom.xml 中添加 -->
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-tomcat</artifactId>
       <scope>provided</scope>
   </dependency>
   

2. Spring Boot JPA配置强化：
   在application.properties/application.yml中明确配置JPA参数，确保Spring Boot完全掌控Hibernate的行为：

   # 示例MySQL配置，根据你的数据库调整
   spring.jpa.hibernate.ddl-auto=update
   spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQLDialect
   spring.jpa.show-sql=true
   

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