SpringBoot Web应用404错误（Windows与Mac运行差异问题）

问题描述 #

我正在学习SpringBoot开发Web应用，遇到了显示状态码404的WhiteLabel错误页面。我的控制器代码如下：

@Controller
public class HomeController {
    @RequestMapping("/")
    public String home(){
        System.out.println("nskjdnwmndkjnwekd wklndwkelkx");
        return "index.jsp";
    }
}

项目结构中，HomeController类位于Controller文件夹中。我已在pom文件中添加tomcat jasper依赖，尝试添加jstl依赖后问题仍未解决。补充：该项目在Mac设备上可正常运行，但在Windows设备上无法运行，请问可能是什么原因？

可能的原因及解决办法 #

• 文件路径大小写不匹配：Mac文件系统默认不区分大小写，Windows则严格区分。检查index.jsp实际文件名是否与代码返回值完全一致——比如代码写index.jsp但实际文件是Index.jsp，Mac能识别但Windows会找不到。
• JSP视图路径配置错误：SpringBoot默认JSP存放路径为src/main/webapp/WEB-INF/jsp/，若你的index.jsp在其他位置，需在application.properties中配置视图解析器：

  spring.mvc.view.prefix=/WEB-INF/jsp/
  spring.mvc.view.suffix=.jsp
  

  确保配置路径与实际文件位置匹配，Windows下路径分隔符用/或转义的\\均可，注意拼写无误。
• webapp资源未被正确打包：检查pom.xml是否配置了webapp目录的资源过滤，确保JSP能被打包到产物中。在<build>节点下添加：

  <resources>
      <resource>
          <directory>src/main/webapp</directory>
          <targetPath>META-INF/resources</targetPath>
          <includes>
              <include>**/**</include>
          </includes>
      </resource>
  </resources>
  

• 依赖版本兼容性问题：Windows下可能存在tomcat jasper与SpringBoot内置Tomcat版本不匹配的情况，建议使用SpringBoot starter管理依赖，避免手动指定版本：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-tomcat</artifactId>
      <scope>provided</scope>
  </dependency>
  <dependency>
      <groupId>org.apache.tomcat.embed</groupId>
      <artifactId>tomcat-embed-jasper</artifactId>
      <scope>provided</scope>
  </dependency>
  

• IDE编译缓存问题：Windows下IDE（如IntelliJ IDEA、Eclipse）可能存在编译缓存残留。尝试删除target目录，执行"Clean Project"和"Rebuild Project"操作。
• 文件权限限制：Windows下JSP所在目录可能存在权限问题，导致Tomcat无法读取文件。检查文件及文件夹权限，确保运行项目的用户拥有读取权限。

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