JSF应用中XHTML文件浏览器问题：login.xhtml作为初始页异常

看起来你在把login.xhtml设为JSF应用的初始页面时遇到了显示或访问问题，我来帮你一步步排查和解决常见的问题点：

1. 检查web.xml的欢迎页面配置 #

首先要确保你的Web应用已经明确告诉容器，默认加载的页面是login.xhtml。打开web.xml文件，确认是否有以下配置：

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

注意：如果login.xhtml存放在子目录（比如/views/login.xhtml），这里需要填写完整的相对路径。

2. 确认JSF FacesServlet的映射配置 #

JSF页面需要通过FacesServlet来解析渲染，所以要确保web.xml里的Servlet映射正确配置，让.xhtml后缀的文件能被处理：

<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>

如果你的映射是/faces/*这类前缀模式，那么访问初始页面可能需要用/faces/login.xhtml，这会导致默认欢迎页面无法直接触发JSF处理，所以推荐用*.xhtml的后缀映射更直观。

3. 检查login.xhtml的代码完整性 #

你提供的代码片段不完整，JSF页面必须有完整的结构才能正常渲染。要确保页面包含<h:body>标签，所有标签都正确闭合，比如一个完整的login页面示例：

<!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:h="http://java.sun.com/jsf/html" 
      xmlns:f="http://java.sun.com/jsf/core" 
      xmlns:ui="http://java.sun.com/jsf/facelets"> 
    <h:head> 
        <title><ui:insert name="title">Spring-Security - Login</ui:insert></title>
    </h:head>
    <h:body>
        <h:form id="loginForm">
            <div>
                <h:outputLabel for="username" value="Username:" />
                <h:inputText id="username" value="#{loginBean.username}" required="true" />
                <h:message for="username" style="color:red;" />
            </div>
            <div>
                <h:outputLabel for="password" value="Password:" />
                <h:inputSecret id="password" value="#{loginBean.password}" required="true" />
                <h:message for="password" style="color:red;" />
            </div>
            <div>
                <h:commandButton value="Login" action="#{loginBean.authenticate}" />
            </div>
        </h:form>
    </h:body>
</html>

重点检查：是否遗漏了<h:body>，是否有未闭合的标签，JSF命名空间是否正确声明。

4. 排查Spring Security的拦截规则 #

因为你的页面标题提到了Spring-Security，这很可能是问题的关键点：如果Spring Security拦截了login页面的访问，未登录用户会被重定向，导致页面无法正常显示。

XML配置方式 #

确保在Spring Security配置文件中允许匿名访问login.xhtml：

<security:http auto-config="true">
    <!-- 允许所有人访问登录页面 -->
    <security:intercept-url pattern="/login.xhtml" access="permitAll"/>
    <!-- 其他页面需要认证 -->
    <security:intercept-url pattern="/**" access="hasRole('USER')"/>
    <!-- 指定登录页面 -->
    <security:form-login login-page="/login.xhtml" 
                         default-target-url="/home.xhtml"
                         authentication-failure-url="/login.xhtml?error=true"/>
</security:http>

Java配置类方式 #

如果用Java代码配置Spring Security：

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                // 允许匿名访问登录页面及错误跳转页
                .antMatchers("/login.xhtml", "/login.xhtml?error=true").permitAll()
                .anyRequest().authenticated()
                .and()
            .formLogin()
                .loginPage("/login.xhtml")
                .defaultSuccessUrl("/home.xhtml")
                .failureUrl("/login.xhtml?error=true");
    }
}

注意：要把登录页面以及错误跳转的URL都加入permitAll规则，避免被拦截。

5. 浏览器端排查 #

如果以上配置都没问题，试试以下操作：

• 清除浏览器缓存，或者用无痕模式访问，避免缓存的旧页面干扰
• 打开浏览器开发者工具（F12），查看控制台是否有JS错误，查看网络标签是否有404/403/500等错误状态码，这些信息能快速定位具体问题

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