SSM設(shè)置歡迎頁的三種方式總結(jié)

更新時間：2026年02月01日 11:12:02 作者：好好研究

這篇文章主要介紹了SSM項目設(shè)置歡迎頁的三種方式：使用web.xml配置、使用SpringMVC-mvc:view-controller配置和使用SpringMVC-Controller配置,每種方式都有其適用場景、優(yōu)點和缺點,需要的朋友可以參考下

SSM項目設(shè)置歡迎頁

前期準(zhǔn)備

pom.xml文件引入Servlet和SpringMVC基礎(chǔ)依賴（保證項目能運行）

  <!-- 僅需引入Servlet和SpringMVC基礎(chǔ)依賴（保證項目能運行） -->
  <dependencies>
    <!--springmvc框架的核心依賴-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>

web.xml文件添加前端控制器、監(jiān)聽器、過濾器（解決中文亂碼的問題）

<?xml version="1.0" encoding="UTF-8"?>
<web-app
    version="3.1"
    xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:javaee="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:xml="http://www.w3.org/XML/1998/namespace"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                        http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd">
    <!--前端控制器-->
    <servlet>
        <servlet-name>dispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--初始化參數(shù)，加載springmvc.xml配置文件-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <!--啟動加載-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcherServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!--監(jiān)聽器-->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>

    <!--過濾器，解決中文亂碼的問題-->
    <filter>
        <filter-name>characterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

方式一：使用web.xml配置歡迎頁（最基礎(chǔ)且推薦）

使用web.xml配置歡迎頁是容器默認(rèn)方式。

配置代碼
在 src/main/webapp/WEB-INF/web.xml 下使用 <welcome-file-list> 標(biāo)簽配置歡迎頁

    <!-- 配置歡迎頁 -->
    <welcome-file-list>
        <welcome-file>index.html</welcome-file><!-- 先找這個 -->
        <welcome-file>index.jsp</welcome-file> <!-- 找不到再找這個 -->
        <welcome-file>index</welcome-file>     <!-- 最后找這個 -->
        <!--<welcome-file>WEB-INF/static/index.jsp</welcome-file>--><!-- × 錯誤寫法 -->
    </welcome-file-list>

訪問位置

注意：
1. 訪問的是 webapp 根目錄下的 index.jsp 歡迎頁，不是 static/ 或 WEB-INF/ 下的
2. 不需要編寫Controller層，不需要經(jīng)過 SpringMVC 的 DispatcherServlet，Tomcat會直接解析。

適用場景
適合靜態(tài)的 HTML 或 JSP，且直接放在 webapp (或 WebContent) 根目錄下，沒有放在 WEB-INF 里。
注意事項
1. web.xml配置中有文件查找順序
2. DispatcherServlet影響：如果配置了 <url-pattern>/</url-pattern>，可能會攔截歡迎頁請求。需要配置靜態(tài)資源處理或使用 <mvc:default-servlet-handler/>
3. 安全考慮：業(yè)務(wù)頁面建議放在 /WEB-INF/ 下，通過Controller訪問；靜態(tài)首頁可以放在webapp根目錄。

方式二：使用SpringMVC-mvc:view-controller配置歡迎頁

配置代碼
1. pom.xml同前期準(zhǔn)備內(nèi)容一樣
2. web.xml內(nèi)容同方式一中的內(nèi)容一樣，添加<welcome-file-list> 標(biāo)簽
3. 在 src/main/webapp/WEB-INF/views/ 下使新建 index.jsp頁面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h2>SpringMVC-mvc:view-controller配置歡迎頁</h2>
    <p>訪問路徑：WEB-INF/views/index.jsp</p>
</body>
</html>

在 src/main/resources/springmvc.xml 配置文件中配置歡迎頁

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                           http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/mvc
                           http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 開啟mvc注解驅(qū)動 -->
    <mvc:annotation-driven/>

    <!-- 配置歡迎頁 -->
    <mvc:view-controller path="/" view-name="index"/>

    <!-- 配置視圖解析器 -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--頁面前綴-->
        <property name="prefix" value="/WEB-INF/views/"></property>
        <!--頁面后綴-->
        <property name="suffix" value=".jsp"></property>
    </bean>

</beans>

運行會發(fā)現(xiàn)依然找的是webapp根目錄下的index.jsp頁面。
問題：即使web.xml中沒有配置<welcome-file-list>，Tomcat容器本身有默認(rèn)的歡迎頁查找機制。當(dāng)訪問應(yīng)用根路徑時，Tomcat會按以下順序自動查找：
1. index.html
2. index.htm
3. index.jsp
這就是為什么你訪問根路徑時，還是看到了/webapp/index.jsp，而不是/WEB-INF/views/index.jsp。

解決問題
1. 解決方法一：刪除webapp根目錄下的index.jsp頁面
2. 解決方法二：添加跳轉(zhuǎn)頁面代碼
  1. 在 webapp根目錄下的index.jsp頁面中添加跳轉(zhuǎn)

<%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="UTF-8" %>
<html>
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <script>
        // 自動跳轉(zhuǎn)到Spring MVC處理的首頁
        window.location.href = "${pageContext.request.contextPath}/index";
    </script>
</head>
<body>
<h2><%= "Hello World!" %></h2>
</body>
</html>

2. 將 src/main/resources/springmvc.xml 配置文件中的

<mvc:view-controller path="/" view-name="index"/>
修改為（或添加）
<mvc:view-controller path="/index" view-name="index"/>
就訪問成功了

訪問位置
訪問 WEB-INF/views/index.jsp 頁面

適用場景
頁面在 WEB-INF 下，但不需要執(zhí)行任何 Java 業(yè)務(wù)邏輯，只是單純的跳轉(zhuǎn)顯示。
注意事項
由于Tomcat容器本身有默認(rèn)的歡迎頁查找機制，所有配置有些麻煩。

方式三：使用SpringMVC-Controller配置歡迎頁（最常用）

配置代碼
1. pom.xml同前期準(zhǔn)備內(nèi)容一樣
2. web.xml內(nèi)容同方式一中的內(nèi)容一樣，添加<welcome-file-list> 標(biāo)簽
3. 在 webapp根目錄下的index.jsp頁面中添加跳轉(zhuǎn)，與方式二中解決問題方法二的代碼一樣
4. 在 src/main/webapp/WEB-INF/views/ 下使新建 index.jsp頁面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h2>SpringMVC-Controller配置歡迎頁</h2>
    <p>訪問路徑：WEB-INF/views/index.jsp</p>
</body>
</html>

在 src/main/resources/springmvc.xml 配置文件中配置歡迎頁內(nèi)容在方式二的基礎(chǔ)上添加掃描包代碼

<!-- 配置spring創(chuàng)建容器時要掃描的包 -->
<context:component-scan base-package="com.qcby"></context:component-scan>

在controller層

package com.qcby.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class WelcomeController {

    @RequestMapping("/")
    public String index(){
        return "index";
    }
}

訪問位置
訪問 WEB-INF/views/index.jsp 頁面

適用場景
1. 頁面放在 WEB-INF 目錄下（最安全）
2. 需要查詢數(shù)據(jù)、處理業(yè)務(wù)邏輯或使用模板引擎
3. 通過SpringMVC攔截/請求并轉(zhuǎn)發(fā)到指定的視圖

總結(jié)

方式	訪問路徑	配置位置	優(yōu)點	缺點
方式一：web.xml歡迎頁	`webapp/index.jsp`	webapp根目錄	簡單，快速	無法使用Spring MVC功能
方式二：mvc:view-controller	`WEB-INF/views/index.jsp`	WEB-INF目錄	安全，可通過Controller處理	配置復(fù)雜，需要正確Spring MVC配置
方式三：Controller	`WEB-INF/views/index.jsp`	Controller轉(zhuǎn)發(fā)	最靈活，可添加業(yè)務(wù)邏輯	需要寫代碼