Tomcat10.1.7+JDK17环境下PrimeFaces项目部署失败求助

核心问题分析 #

你遇到的两类错误本质是JSF实现依赖冲突和组件初始化配置不当：

1. MyFaces初始化报错：项目同时引入了MyFaces与Mojarra两种JSF实现，Tomcat启动时无法确定默认实现，引发工厂类加载冲突。
2. Mojarra空指针错误：resourceHandler为空是因为JSF核心组件初始化不完整，大概率是依赖版本不兼容或缺失关键配置。

具体修复步骤 #

1. 清理JSF实现依赖冲突 #

PrimeFaces仅需依赖单一JSF实现，推荐使用Mojarra（PrimeFaces官方适配性更好）。在pom.xml中调整依赖：

• 移除所有MyFaces相关依赖
• 明确引入与Tomcat10.1.x、JDK17兼容的Mojarra版本（推荐4.0.x或4.1.x）
• 排除PrimeFaces自带的JSF API传递依赖，避免版本冲突

示例pom.xml依赖配置：

<!-- JSF API -->
<dependency>
    <groupId>jakarta.faces</groupId>
    <artifactId>jakarta.faces-api</artifactId>
    <version>4.0.1</version>
</dependency>
<!-- Mojarra JSF实现 -->
<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>jakarta.faces</artifactId>
    <version>4.0.3</version>
</dependency>
<!-- PrimeFaces（匹配JSF 4.0版本） -->
<dependency>
    <groupId>org.primefaces</groupId>
    <artifactId>primefaces</artifactId>
    <version>12.0.0</version>
    <exclusions>
        <exclusion>
            <groupId>jakarta.faces</groupId>
            <artifactId>jakarta.faces-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 修正web.xml配置 #

确保使用Jakarta EE命名空间（Tomcat10+已全面切换到Jakarta规范），并正确配置Faces Servlet：

<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_6_0.xsd"
         version="6.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>

    <context-param>
        <param-name>jakarta.faces.PROJECT_STAGE</param-name>
        <param-value>Development</param-value>
    </context-param>
</web-app>

3. 验证版本兼容性 #

确保各依赖版本匹配：

• JSF 4.0 → PrimeFaces 12.0.0+
• JDK17要求PrimeFaces版本≥11.0.0

4. 清理并重新构建项目 #

执行Maven命令清理旧构建文件，避免残留依赖干扰：

mvn clean install

5. 检查Tomcat全局依赖 #

确认Tomcat的lib目录中无残留的MyFaces或旧版本JSF文件，若存在则删除，避免与WAR包内依赖冲突。

验证步骤 #

1. 将重新打包的WAR部署到Tomcat10.1.7
2. 查看Tomcat启动日志，确认无JSF初始化错误
3. 访问index.xhtml页面，检查页面是否正常加载

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