WildFly模块中Persistence unit未找到问题及场景说明

我在WildFly上跑了好几个WAR应用，每个都需要一个带缓存的kill switch过滤器——本质是查数据库里的标志位，根据配置走不同逻辑。之前把这个killswitch.jar直接打包进每个WAR，再配置web.xml，功能完全正常，但架不住每个WAR都拷一遍Jar，维护起来太麻烦，所以想把它做成WildFly模块，统一管理。

我已经把Jar和module.xml放到了WildFly模块的正确路径（modules/system/layers/base/my/company/domain/killswitch/main下面），模块也确实加载成功了，但现在一跑就报**"Persistence unit not found in wildfly module"**的错误。

我的module.xml长这样：

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.0" name="my.company.domain.killswitch">
    <resources>
        <resource-root path="killswitch.jar"/>
    </resources>
    <dependencies>
        <module name="org.jboss.logging"/>
        <module name="javax.api"/>
        <module name="com.microsoft.sqlserver"/>
        <module name="org.slf4j.jcl-over-slf4j"/>
        <module name="org.jboss.as.web" />
        <module name="javax.servlet.api" />
        <module name="javax.persistence.api" />
        <module name="javax.api"/>
        <module name="javax.inject.api"/>
        <module name="org.hibernate" services="import"/>
        <!-- 后面还有一些依赖，核心的都列出来了 -->
    </dependencies>
</module>

之前把Jar塞WAR里的时候，过滤器能正常读取WAR里META-INF/persistence.xml定义的持久化单元，现在做成模块就找不到了，有没有大佬知道怎么解决？

这个问题其实是WildFly的类加载隔离机制搞的鬼——模块是在独立的类加载器里跑的，默认看不到WAR应用自己的类和资源（包括persistence.xml），之前打包进WAR的时候，过滤器和PU在同一个类加载上下文里，所以没问题。下面给你几个可行的解决办法，按需选：

1. 让模块能访问WAR的持久化单元（推荐，保留每个WAR的独立PU） #

这种方式适合每个WAR用不同PU的场景，核心是让模块依赖WAR的类加载器：

• 给每个WAR加个jboss-deployment-structure.xml（放WAR的WEB-INF下面），内容如下：

  <jboss-deployment-structure>
      <deployment>
          <dependencies>
              <!-- 引入我们的kill switch模块 -->
              <module name="my.company.domain.killswitch" export="true" />
              <!-- 关键：让模块能访问当前WAR的类和资源 -->
              <module name="deployment.你的WAR名称.war" export="true" />
          </dependencies>
      </deployment>
  </jboss-deployment-structure>
  

  记得把你的WAR名称换成实际的WAR文件名（比如你WAR叫user-service.war，就写user-service）。
• 另外，可以在模块的module.xml里加个可选依赖，增强兼容性：

  <dependencies>
      <!-- 其他已有的依赖 -->
      <module name="deployment" optional="true" />
  </dependencies>
  

2. 把持久化单元移到模块里（适合所有WAR共享同一个PU） #

如果所有WAR都用同一个数据库、同一个PU配置，那直接把persistence.xml放到模块里就行：

• 在模块的main目录下建个META-INF文件夹，把persistence.xml放进去。
• 修改模块的module.xml，把当前目录也加为资源根：

  <resources>
      <resource-root path="killswitch.jar"/>
      <resource-root path="."/> <!-- 这样就能加载META-INF下的persistence.xml了 -->
  </resources>
  

• 还要确保模块依赖全了，比如补充Hibernate的核心模块：

  <dependencies>
      <!-- 其他现有依赖 -->
      <module name="org.hibernate.core" services="import"/>
      <module name="org.hibernate.jpa" services="import"/>
  </dependencies>
  

  这样所有WAR用这个模块的时候，都会用模块里的PU，适合统一配置的场景。

3. 代码里用JNDI直接找PU #

修改过滤器的代码，不依赖类加载器扫描，直接通过JNDI查PU：

// 替换成你WAR里PU的名称
EntityManagerFactory emf = (EntityManagerFactory) new InitialContext().lookup("java:jboss/persistence-unit/MyPersistenceUnit");

这种方式需要注意，如果每个WAR的PU名称不一样，那得给过滤器加个初始化参数，让每个WAR能配置自己的PU名称，比如在web.xml里加：

<filter>
    <filter-name>KillSwitchFilter</filter-name>
    <filter-class>你的过滤器全类名</filter-class>
    <init-param>
        <param-name>persistenceUnitName</param-name>
        <param-value>MyPersistenceUnit</param-value>
    </init-param>
</filter>

然后过滤器里读取这个参数，再拼JNDI路径查找。

• 缓存要注意线程安全：模块是所有WAR共享的，过滤器里的缓存别搞成全局静态变量，不然不同应用的数据会串。
• 依赖要检查全：比如org.hibernate模块一定要加services="import"，不然Hibernate的服务加载不起来。
• 类冲突处理：如果遇到类重复加载的问题，可以在jboss-deployment-structure.xml里调整依赖优先级，比如用exclude-subsystems或者local-last属性。

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