Spring MVC+Tomcat仅渲染index.jsp，控制器失效问题求助

问题现象 #

• 访问http://localhost:8080/spring_course_mvc/时，未添加webapp/index.jsp会出现404错误；添加后可正常显示该页面，但控制器映射的根路径方法未触发。
• 控制器中映射/的方法本应返回WEB-INF/view/first-view.jsp，但无法生效；将first-view.jsp直接放在webapp目录下，可通过http://localhost:8080/spring_course_mvc/first-view.jsp正常访问。

配置文件与代码 #

web.xml 文件 #

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         id="WebApp_ID" version="3.1">

  <display-name>spring-course-mvc</display-name>

  <absolute-ordering />

  <servlet>
    <servlet-name>dispatcher</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>/WEB-INF/applicationContext.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>

  <servlet-mapping>
    <servlet-name>dispatcher</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

</web-app>

applicationContext.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:context="http://www.springframework.org/schema/context"
       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/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <context:component-scan base-package="com.myapp.spring.mvc" />

    <mvc:annotation-driven/>

    <bean
            class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/view/" />
        <property name="suffix" value=".jsp" />
    </bean>

</beans>

控制器代码 #

package com.myapp.spring.mvc;

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

@Controller
public class MyController {

    @RequestMapping("/")
    public String showFirstView() {
        return "first-view";
    }
}

pom.xml 文件 #

<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>com.myapp.spring.mvc</groupId>
  <artifactId>spring_course_mvc</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>spring_course_mvc Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>6.1.7</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>6.1.7</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>6.1.7</version>
    </dependency>

    <dependency>
      <groupId>jakarta.servlet.jsp.jstl</groupId>
      <artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
      <version>3.0.0</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>6.1.7</version>
    </dependency>

  </dependencies>
  <build>
    <finalName>spring_course_mvc</finalName>
  </build>
</project>

问题原因与解决方案 #

核心原因 #

Tomcat的默认Servlet会优先处理根路径请求，当webapp目录下存在index.jsp时，Tomcat会直接返回该页面，不会将请求转发给Spring的DispatcherServlet；即使没有index.jsp，Tomcat的欢迎页面机制也可能导致请求未被DispatcherServlet接管。

解决方案 #

1. 修改web.xml，禁用Tomcat欢迎页面自动处理

在web.xml中添加欢迎页面配置，让DispatcherServlet接管根请求：

<welcome-file-list>
    <welcome-file></welcome-file>
</welcome-file-list>

这样Tomcat不会自动寻找默认的index.jsp，请求会被DispatcherServlet处理，触发控制器的/映射方法。

2. 确认视图文件路径

确保WEB-INF/view/目录存在，且first-view.jsp正确放置在该目录下，路径与视图解析器的prefix和suffix配置完全匹配。

3. 补充Jakarta Servlet API依赖

Spring 6.x基于Jakarta EE 9+，需添加对应Servlet API依赖，否则DispatcherServlet可能无法正常工作。在pom.xml中添加：

<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
    <version>6.0.0</version>
    <scope>provided</scope>
</dependency>

provided表示依赖由Tomcat提供，避免打包时冲突。

4. 清理并重新部署

• 执行mvn clean清理项目
• 执行mvn package重新构建war包
• 重启Tomcat并重新部署应用

验证 #

修改完成后，删除webapp/index.jsp，访问http://localhost:8080/spring_course_mvc/，应正常显示WEB-INF/view/first-view.jsp的内容。

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