在tomcat中部署JSF2应用时看不到欢迎页面答案

【问题标题】：Can't see the welcome page when deploying JSF2 app in tomcat在tomcat中部署JSF2应用时看不到欢迎页面
【发布时间】：2012-12-26 22:16:32
【问题描述】：

我想使用 mvn tomcat:run 在 tomcat 上部署我的 JSF2 应用程序。我之前确实使用mvn clean install 命令正确编译过它。 Tomcat 对我说 INFO: Starting Coyote HTTP/1.1 on http-8080

我想知道我是否正确配置了欢迎页面。这是我的 web.xml：

 <?xml version="1.0" encoding="UTF-8"?>
<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_2_5.xsd"
    version="2.5">

    <display-name>Archetype Created Web Application</display-name>

    <context-param>
        <param-name>javax.faces.PROJECT_STAGE</param-name>
        <param-value>Development</param-value>
    </context-param>

    <servlet>
        <servlet-name>Faces Servlet</servlet-name>
        <servlet-class>javax.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>

    <welcome-file-list>
        <welcome-file>home.xhtml</welcome-file>
    </welcome-file-list>


</web-app>

这是我的 pom.xml，只是为了仔细检查 artifactid 是否正确：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.bogus</groupId>
    <artifactId>jsf2_tutorial</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>jsf2_tutorial Maven Webapp</name>
    <url>http://maven.apache.org</url>

    <repositories>
        <repository>
            <id>maven2-repository.dev.java.net</id>
            <name>Java.net Repository for Maven</name>
            <url>http://download.java.net/maven/2</url>
        </repository>
    </repositories>

    <dependencies>

        <dependency>
            <groupId>com.sun.faces</groupId>
            <artifactId>jsf-api</artifactId>
            <version>2.1.0-b03</version>
            <scope>compile</scope>
        </dependency>
        <dependency>
            <groupId>com.sun.faces</groupId>
            <artifactId>jsf-impl</artifactId>
            <version>2.1.0-b03</version>
            <scope>compile</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.3.2</version>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

我要粘贴最后一点，home.xhtml 以确保它也是正确的：

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
    xmlns:ui="http://java.sun.com/jsf/facelets"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:h="http://java.sun.com/jsf/html">
    <h:head>
        <title>Hello JSF 2!</title>
    </h:head>
    <h:body>
       #{welcome.message}
    </h:body>
</html>

我导航到欢迎页面时的错误是：

HTTP status 500
In the url I notice I had a typo. Now I enter the correct URL but the problem is:

    type Exception report

    message

    description The server encountered an internal error () that prevented it from fulfilling this request.

    exception

javax.servlet.ServletException: Class javax.faces.webapp.FacesServlet is not a Servlet
    org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)
    org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)
    org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:857)
    org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)
    org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)
    java.lang.Thread.run(Thread.java:662)

root cause

java.lang.ClassCastException: javax.faces.webapp.FacesServlet cannot be cast to javax.servlet.Servlet
    org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)
    org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)
    org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:857)
    org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)
    org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)
    java.lang.Thread.run(Thread.java:662)

    note The full stack trace of the root cause is available in the Apache Tomcat/6.0.29 logs.

更新

我通过从 pom.xml 中删除 servlet-api 依赖项摆脱了异常

 <dependency>  <groupId>javax.servlet</groupId> 
 <artifactId>servlet-api</artifactId>  <version>2.5</version> 
 </dependency>

页面现在加载，但没有显示消息。这是这个应用程序的 java 部分的样子：

package org.bogus;
import javax.faces.bean.ManagedBean;

@ManagedBean(name = "welcome", eager = true)
public class WelcomeBean {
    public WelcomeBean() {
        System.out.println("WelcomeBean instantiated");
    }
    public String getMessage() {
        return "I'm alive!";
    }
}

这个例子和oracle官方JSF教程中的几乎一样：http://docs.oracle.com/javaee/6/tutorial/doc/gjaam.html

我包含了<load-on-startup>1</load-on-startup>，但我仍然没有在控制台或页面中看到该消息。也许配置仍然有问题。有什么想法吗？

更新我刚刚在WEB-INF 下包含了faces-config.xml 文件，但仍然不起作用：

<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is not required if you don't need any extra configuration. -->
<faces-config version="2.1"
   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-facesconfig_2_1.xsd">

   <!-- Write your navigation rules here. -->

   <application>
        <locale-config>
            <default-locale>en</default-locale>
            <supported-locale>en</supported-locale>
        </locale-config>
   </application>

</faces-config>

【问题讨论】：

在我删除的答案中，我说要使用与容器自己的 servlet 版本匹配的 web.xml servlet 版本。对于 Tomcat 6，它是 Servlet 2.5。你告诉我它不起作用，我认为这是一个 Maven 的东西。但是现在您已经更新了您的问题，将web.xml 编辑为 Servlet 3.0 而不是 2.3。但它应该是 Servlet 2.5，如我已删除的答案中所述。如果您使用不受支持的 servlet 版本，则容器将以与受支持的最低 servlet 版本匹配的回退方式运行。
@BalusC 我刚刚更新了问题，我更改为 2.5 版，但我看到一些与 Servlet 相关的异常。不确定我认为我确实正确更改了版本
例外肯定是有帮助的。 JSF 的初始化现在已成功触发，但最终由于类路径损坏而失败。您的 Maven 构建肯定是损坏的。我不做 Maven，但最终，Maven 生成的 WAR 文件/结构的 /WEB-INF/lib 文件夹应该仅包含 jsf-api、jsf-impl、jstl-api、jstl-impl JARs 而不是其他的，绝对不是异常似乎暗示的servlet-api。我猜你必须在 provided 范围内声明 Servlet API（因为它已经由目标容器提供，即 Tomcat）。
@BalusC 我很困惑，我的WEB-INF 不包含lib 文件夹。我应该创建它吗？目前我的WEB-INF 中只有一个名为classes 的文件夹（其中包含beans.xml）和web.xml 文件
@BalusC 我想我已经接近了。我从pom.xml <dependency> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> <version>2.5</version> </dependency> 中删除了以下依赖项现在也不例外，页面似乎加载但没有显示消息。我将使用 Java 类更新

标签： java jsf maven tomcat jsf-2

【解决方案1】：

你基本上有两个问题：

JSF2 至少需要 Servlet 2.5（与 Tomcat 6 兼容），但您的 web.xml 被声明为符合 Servlet 2.3（与 Tomcat 4 兼容）。您应该将您的 web.xml 声明为与 servletcontainer 兼容的最高版本。鉴于它是 Tomcat 6，它是一个 Servlet 2.5 容器，请将其声明为 Servlet 2.5。
```
<?xml version="1.0" encoding="UTF-8"?>
<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_2_5.xsd"
    version="2.5">

    

</web-app>
```
（是的，没有文档类型！）
Mojarra 2.1.0 的@ManagedBean 无法在 Tomcat 和 Jetty 上运行，因为在注释扫描代码中意外插入了 Glassfish 特定代码。另见issue 1937。您需要至少升级到 Mojarra 2.1.1（或仅升级到当前可用的 2.1.17）。另一种方法是在 faces-config.xml 中手动注册托管 bean，但这很笨拙。

与具体问题无关，@ManagedBean(eager=true) 仅适用于 @ApplicationScoped。直接省略即可。

【讨论】：

我刚刚修复了我的web.xml 以使用该代码（没有文档类型）。问题依然存在。这是我使用mvn Apache Tomcat/6.0.29 运行的tomcat 版本
是的，我更喜欢使用JBoss，可能我会回到它。无论如何，很高兴知道为什么不工作的确切原因。我不明白的一件事是如何升级 mojarra？这是我应该在pom.xml 中添加的内容吗？感谢您的帮助 BalusC。
你可以在几乎所有的maven库的下载页面找到maven坐标。对于 Mojarra，它是这个页面：javaserverfaces.java.net/download.html 将 API 和 impl 的两个条目替换为单个条目 <dependency> <groupId>org.glassfish</groupId> <artifactId>javax.faces</artifactId> <version>2.1.17</version> </dependency>