JSF代码无法显示：Tomcat无法识别已安装的JSF及JSTL依赖
我来帮你一步步梳理这个问题——IDEA能正常识别JSF，但部署到Tomcat后就失效，这种情况大概率是依赖部署范围或者配置遗漏导致的，咱们逐个排查：
1. 检查Maven/Gradle依赖的部署范围
你用到的javax.faces 2.1.14是JSF的核心实现，Tomcat作为纯Servlet容器，本身并不自带JSF库。如果你的依赖配置里把它设成了<scope>provided</scope>，IDEA会在编译时识别，但打包war包时不会把它包含进去，Tomcat运行时自然找不到JSF类。
解决方法：
打开你的pom.xml，把javax.faces的依赖范围改成compile（默认就是compile，如果你没改的话可以跳过这步，但最好确认一下）：
<dependency> <groupId>com.sun.faces</groupId> <artifactId>jsf-api</artifactId> <version>2.1.14</version> <scope>compile</scope> </dependency> <dependency> <groupId>com.sun.faces</groupId> <artifactId>jsf-impl</artifactId> <version>2.1.14</version> <scope>compile</scope> </dependency>
（注意：有些版本的javax.faces是合包的，单个jar就包含api和impl，根据你的实际依赖调整即可）
2. 确认web.xml中的JSF配置是否完整
JSF需要在web.xml中注册FacesServlet并配置映射，否则Tomcat不知道该把JSF请求交给哪个组件处理。
添加以下配置到web.xml中：
<!-- 注册Faces Servlet --> <servlet> <servlet-name>Faces Servlet</servlet-name> <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> <load-on-startup>1</load-on-startup> <!-- 启动时加载，避免首次请求延迟 --> </servlet> <!-- 配置JSF请求映射，这里用*.xhtml示例，也可以用*.jsf --> <servlet-mapping> <servlet-name>Faces Servlet</servlet-name> <url-pattern>*.xhtml</url-pattern> </servlet-mapping>
同时注意web.xml的版本：JSF 2.1要求Servlet版本至少2.5，对应Tomcat 6及以上，如果你用的是Tomcat 7+，web.xml的根标签应该是：
<web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0">
3. 检查JSF页面的命名空间声明
你的JSF页面（.xhtml文件）必须正确声明JSF的命名空间，否则Tomcat会把它当成普通HTML处理。确保页面的根标签包含以下命名空间：
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:h="http://java.sun.com/jsf/html" xmlns:f="http://java.sun.com/jsf/core">
比如使用<h:head>、<h:body>代替原生的<head>、<body>，这样才能触发JSF的解析逻辑。
4. 避免Tomcat全局库冲突
不要手动把JSF的jar包放到Tomcat的lib目录下（除非你是多应用共享JSF），否则可能和你war包里的版本冲突，导致加载异常。如果之前放了，建议移除，让war包自带自己的JSF依赖。
5. 查看Tomcat日志定位具体错误
如果以上步骤都试过还是不行，去Tomcat的logs目录查看localhost.log或者catalina.out，里面会有详细的报错信息——比如找不到FacesServlet类、初始化失败等，这些日志能帮你精准定位问题。
内容的提问来源于stack exchange，提问作者Диас
