Spring Boot 3升级后集成Jakarta Faces 4启动失败求助

这个错误的核心是Spring Boot 3 + Jakarta EE 10 + Jakarta Faces 4 整合时的依赖冲突或配置不兼容，具体表现为FacesContext初始化时无法获取正确的Factory实例，导致空指针。以下是针对性的解决步骤：

1. 严格对齐依赖版本 #

Spring Boot 3.0.x 强制依赖Jakarta EE 10，必须确保所有GUI相关依赖都适配Jakarta EE 10规范：

• Mojarra：必须使用4.x版本（推荐4.0.3/4.0.4官方稳定版），禁止混用3.x版本（与Jakarta EE 10不兼容）
• PrimeFaces：必须使用12.x及以上版本（12.0.0+支持Jakarta Faces 4），推荐13.0.0稳定版
• 在pom.xml中明确声明依赖并排除旧的javax.*依赖：

  <!-- Mojarra Jakarta Faces 4 -->
  <dependency>
      <groupId>org.glassfish</groupId>
      <artifactId>jakarta.faces</artifactId>
      <version>4.0.4</version>
  </dependency>
  
  <!-- PrimeFaces 13.x -->
  <dependency>
      <groupId>org.primefaces</groupId>
      <artifactId>primefaces</artifactId>
      <version>13.0.0</version>
      <exclusions>
          <!-- 排除可能残留的javax.faces依赖 -->
          <exclusion>
              <groupId>javax.faces</groupId>
              <artifactId>javax.faces-api</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 执行mvn dependency:tree检查依赖树，确保没有javax.*开头的依赖残留（比如javax.faces、javax.servlet）

2. 修正Faces配置文件 #

• 更新faces-config.xml的命名空间为Jakarta Faces 4.0规范，删除任何手动配置的Factory类：

  <?xml version="1.0" encoding="UTF-8"?>
  <faces-config xmlns="https://jakarta.ee/xml/ns/jakartaee"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-facesconfig_4_0.xsd"
                version="4.0">
      <!-- 仅保留业务相关配置，无需手动注册Factory -->
  </faces-config>
  

• 如果存在web.xml，同步更新为Jakarta EE 10版本：

  <?xml version="1.0" encoding="UTF-8"?>
  <web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
           version="5.0">
      <servlet>
          <servlet-name>Faces Servlet</servlet-name>
          <servlet-class>jakarta.faces.webapp.FacesServlet</servlet-class>
          <load-on-startup>1</load-on-startup>
      </servlet>
      <servlet-mapping>
          <servlet-name>Faces Servlet</servlet-name>
          <url-pattern>*.xhtml</url-pattern>
      </servlet-mapping>
  </web-app>
  

3. 正确使用@FacesConfig注解 #

创建一个Spring可扫描的配置类，明确指定Jakarta Faces版本：

import jakarta.faces.annotation.FacesConfig;
import static jakarta.faces.annotation.FacesConfig.Version.JAKARTA_FACES_4_0;

@FacesConfig(version = JAKARTA_FACES_4_0)
public class FacesConfigBean {
    // 无需额外代码，注解会自动触发Faces环境初始化
}

确保该类所在包被@ComponentScan覆盖。

4. 清理冲突配置 #

• 删除META-INF/services下手动添加的jakarta.faces.context.FacesContextFactory文件，Mojarra 4.x会通过模块系统自动注册Factory，手动配置会导致类加载冲突
• 执行mvn clean install -U清理本地缓存并重新构建，避免旧依赖残留

5. 排查类加载冲突 #

如果问题仍存在，检查Spring Boot启动日志，重点关注：

• 是否有ClassNotFoundException或NoClassDefFoundError提示某个javax.*类缺失
• 是否有重复类加载的警告（比如同一个类从不同jar包加载）

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