如何无需EAR即可将EJB模块与WAR打包并正常部署？

问题原因 #

JNDI查找失败的核心原因是EAR部署和独立WAR部署下EJB的默认JNDI命名空间规则存在差异：

• EAR部署场景下，EJB的JNDI名称是整个EAR内共享的，带java:app前缀的路径在EAR包含的所有WAR、EJB模块内通用，全局路径格式为java:global/[EAR名称]/[EJB模块名]/[EJB名]/[接口名]
• 将EJB包打入每个WAR独立部署后，每个WAR是独立的应用上下文，原来JNDI路径中的EAR层级消失，且每个WAR内的EJB实例完全隔离，当前WAR内的JNDI路径默认仅在该应用内生效，原EAR级的JNDI路径全部失效。

可行解决方案 #

方案1：EJB独立部署为单独应用（适合多WAR共享同一份EJB实例） #

如果业务需要两个WAR共用同一套EJB的事务、缓存、业务逻辑实例，推荐用该方案：

• 把myapp-ejb.jar作为独立的EJB应用部署到容器
• 调整两个WAR项目的maven依赖中，把myapp-ejb的依赖范围设置为provided，避免将EJB包重复打入WAR
• 统一修改代码中所有JNDI查找路径为全局JNDI格式：java:global/[EJB应用部署名]/[EJB实现类名]/[全限定接口名]
  具体路径可以参考容器启动日志中打印的EJB绑定的JNDI名称，直接复制使用即可。

方案2：EJB包打入每个WAR独立使用（适合两个WAR无需共享EJB实例） #

如果接受两个WAR各自运行完全隔离的EJB实例，可以用该方案：

• 将代码中所有JNDI查找路径替换为java:module前缀，移除原java:app前缀的路径，格式为java:module/[EJB实现类名]/[接口名]
• 可以在EJB实现类上添加注解显式指定JNDI名称，避免容器自动生成的路径和查找路径不一致，示例：

  @EJB(name = "java:module/XXXService")
  public class XXXServiceImpl implements XXXService {
  

• 如果使用JBoss/Wildfly、TomEE这类容器，还可以在WAR的WEB-INF目录下添加容器专属的EJB配置文件（如jboss-ejb3.xml），显式配置EJB的JNDI绑定规则。

快速排查技巧 #

部署完成后可以通过容器的管理控制台查看当前应用的JNDI浏览功能，核对EJB实际绑定的JNDI名称和代码中查找的名称是否完全匹配。

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