Spring MVC项目访问根路径报404错误，相关配置及代码排查求助

核心问题原因 #

你当前的Controller仅配置了/home路径的请求映射，没有配置根路径/的映射规则，所以直接访问项目根路径时没有对应的处理器处理请求，就会返回404错误。

解决方法 #

方式一：调整访问路径 #

直接访问你已经配置映射的路径即可，假设你的项目部署上下文路径是/emusicstore，端口号为8080，访问地址为：http://localhost:8080/emusicstore/home

方式二：新增根路径映射 #

如果需要访问根路径直接跳转到首页，修改Controller的请求映射配置即可：

package com.emusicstore.controller;

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

@Controller
public class homeController {
    // 同时匹配根路径和/home路径
    @RequestMapping(value = {"/", "/home"})
    public String home()
    {
        return "home";
    }
}

其他潜在问题排查点 #

• 确认dispatcher-servlet.xml文件存放在WEB-INF目录下，文件名和web.xml中配置的servlet-name完全匹配
• 确认home.jsp文件存放在/WEB-INF/views/目录下，文件名为小写的home.jsp，和Controller返回的视图名一致
• 确认开发工具的项目部署配置正确，访问路径和你配置的项目上下文路径匹配，如果上下文路径不是/，访问时需要添加上下文路径前缀

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