Spring Boot项目导出war包放到tomcat运行跳转到页面出现404报错

### Spring Boot项目导出WAR包并部署到Tomcat遇到404错误的解析与解决方案 在实际开发过程中，经常会遇到将Spring Boot应用打包为WAR格式并部署至Tomcat服务器的需求。这种方式可以更好地与传统Java Web项目的部署方式兼容，便于集成到现有的企业级环境中。然而，在这一过程中可能会遇到各种问题，比如跳转页面时出现404错误，即服务器无法找到指定资源。本文将围绕这一问题进行深入探讨，并提供相应的解决方案。 #### 问题背景与分析 当我们在Spring Boot项目中使用WAR包部署到Tomcat服务器后，访问项目中的某个JSP页面时遇到了404错误，表明服务器未能找到请求的资源。这通常是由以下原因造成的： 1. **WAR包中未包含JSP资源**：Spring Boot默认不会将JSP文件打包进WAR文件中，而是将它们作为静态资源处理。 2. **Tomcat配置问题**：如果Tomcat服务器没有正确配置来识别Spring Boot项目中的JSP资源，则可能导致404错误。 3. **路径问题**：JSP文件的存储位置或访问路径不正确。 #### 解决方案 为了有效解决上述问题，我们需要按照以下步骤操作： 1. **配置Spring Boot项目支持JSP**： - 在IDEA中打开`File -> Project Structure`，选择`Modules`。 - 点击加号图标，添加Web模块。 - 在弹出的窗口中，需要修改两个关键设置：将`Content Root`指向项目的根目录，而`Web Root`则应指向`src/main/webapp`目录，这是Tomcat默认查找静态资源（包括JSP）的位置。 - 完成这些配置后，IDEA会自动创建必要的文件结构，如`web.xml`，以便正确部署到Tomcat。 2. **修改`web.xml`**： - 确保在`web.xml`文件中配置了正确的Servlet映射规则，以便Tomcat能够识别并处理JSP请求。例如，可以在文件中添加如下配置： ```xml <servlet> <servlet-name>default</servlet-name> <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class> <init-param> <param-name>debug</param-name> <param-value>0</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>/static/*</url-pattern> <url-pattern>/WEB-INF/classes/</url-pattern> <url-pattern>/WEB-INF/views/</url-pattern> </servlet-mapping> ``` - 这里指定了默认的Servlet来处理特定的URL模式，确保Tomcat能够找到位于`WEB-INF/views/`下的JSP文件。 3. **调整Spring Boot配置**： - 需要在`application.properties`或`application.yml`文件中指定JSP视图解析器的位置，例如： ```yaml spring.mvc.view.prefix: /WEB-INF/views/ spring.mvc.view.suffix: .jsp ``` 4. **打包WAR文件**： - 使用Maven或Gradle插件构建WAR文件。对于Maven，可以在`pom.xml`中添加如下配置： ```xml <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <classifier>war</classifier> </configuration> </plugin> </plugins> </build> ``` - 执行`mvn clean package`命令即可生成WAR文件。 5. **部署到Tomcat**： - 将生成的WAR文件复制到Tomcat的`webapps`目录下，并重启Tomcat服务器。 通过以上步骤，我们不仅解决了404错误的问题，还确保了Spring Boot项目能够顺利地以WAR包的形式部署到Tomcat服务器上，从而更好地适应不同的部署环境需求。此外，这种做法也有助于提高项目的可维护性和扩展性，是实践中非常实用的方法之一。