Payara 5迁移异常：Jar包中@Initialized观察者方法未被调用

从Payara Micro 4.181迁移到5.2022.3后，带@Observes @Initialized(ApplicationScoped.class) ServletContext参数的初始化方法无法触发，但参数为Object的同名方法能正常执行——这是Payara 5基于Jakarta EE规范带来的兼容性问题。

核心修复：替换Jakarta EE API包名 #

Payara Micro 5.x遵循Jakarta EE 8规范，该规范将原Java EE体系中的javax.*包名全部替换为jakarta.*。你的代码仍使用旧的javax.servlet.ServletContext，导致CDI事件无法匹配到对应的观察者方法。

具体修改：

1. 修改Library.java的导入语句：

   // 替换前
   import javax.servlet.ServletContext;
   // 替换后
   import jakarta.servlet.ServletContext;
   

2. 同步更新项目依赖，确保使用Jakarta EE 8 API（以Maven为例）：

   <dependency>
       <groupId>jakarta.platform</groupId>
       <artifactId>jakarta.jakartaee-api</artifactId>
       <version>8.0.0</version>
       <scope>provided</scope>
   </dependency>
   

备选排查方案 #

如果替换包名后问题依旧，可尝试以下操作：

1. 切换事件监听类型
   Payara 5中@Initialized(ApplicationScoped.class)事件的触发时机可能早于ServletContext初始化，可改为监听ServletContext自身的初始化事件：

   public void initServletContext(@Observes @Initialized(ServletContext.class) ServletContext context) {
       System.out.println(" ### log-2 ServletContext initialized ###");
   }
   

2. 移除重载的观察者方法
   多个重载的观察者方法可能导致CDI匹配逻辑出现歧义，可合并为一个方法并在内部判断参数类型：

   public void init(@Observes @Initialized(ApplicationScoped.class) Object init) {
       System.out.println(" ### log-1 mylib.Library.init(java.lang.Object) called ###");
       if (init instanceof ServletContext) {
           System.out.println(" ### log-2 ServletContext instance detected ###");
       }
   }
   

3. 强制启用CDI特性
   启动Payara Micro时添加--enablecdi参数，确保CDI功能完全激活：

   docker run repissue:v1 --enablecdi
   

验证步骤 #

修改完成后重新部署验证：

1. 重新构建镜像：

   docker build -t repissue:v2 .
   

2. 运行容器：

   docker run repissue:v2
   

3. 查看日志，确认log-2相关输出已正常打印。

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