关于SpringBoot打包war部署到IDEA外的Tomcat访问404的解决

曾经终败给现在 2024-03-30 08:43 40阅读 0赞

### 前言 ###

在学习SpringBoot+JSP打包成war部署到IDEA外，打开Tomcat的时候访问这个打包的项目，404

访问这个项目的地址的时候，有个index.jsp页面，是可以访问的  
![在这里插入图片描述][b7cc1b72bce241e78c31109abda6e86c.png]  
但是Controller层是没办法访问的，访问就报404

package com.powernode.controller;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.ui.Model;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.ResponseBody;
    
    @Controller
    public class JspController {
        
        @RequestMapping("/main")
        public String main(Model model){
        
            model.addAttribute("data", "SpringBoot打包为war文件");
            return "index";
        }
    
        @RequestMapping("/hello")
        @ResponseBody
        public String hello(){
        
            return "hello这个是直接返回的不是返回到视图层的";
        }
    }

### 原因有很多 ###

1.  Application配置类，没有继承SpringBootServletInitializer并且重写configure方法
2.  少写了某个注解
3.  如果在IDEA中SpringBoot的Tomcat插件和IDEA中的独立的Tomcat都可以运行，但是在打包成war就运行不了了，可以查看独立的Tomcat运行版本是多少  
    ![在这里插入图片描述][bc5bc74099824e1aa2b080b225f1d9ec.png]  
    这里主要看Tomcat的版本和JDK的版本

Tomcat的版本和JDK的版本都必须一致，我当前用的是Tomcat9，如果用10的话版本问题更多

如果电脑里（不是IDEA）有多个Tomcat，实际上的环境变量配置应该都只有一个，所以无论启动哪个Tomcat中bin目录下的startup.bat都是启动的环境变量配置好的那个Tomcat，所以这个版本要保证是和打包时候的版本是一致的

JDK我用17的时候是404，换了1.8好了，JDK的版本也是根据环境变量进行配置的，也必须要一致

1.  还有pom.xml配置的问题  
    要在spring-boot-starter-web中，排除Tomcat避免冲突

<dependency>
    	<groupId>org.springframework.boot</groupId>
    	<artifactId>spring-boot-starter-web</artifactId>
    	
    	<exclusions>
    		<exclusion>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-tomcat</artifactId>
    		</exclusion>
    	</exclusions>
    </dependency>

需要加入Servlet依赖

<dependency>
    	<groupId>javax.servlet</groupId>
    	<artifactId>javax.servlet-api</artifactId>
    	<version>3.1.0</version>
    	<scope>provided</scope>
    </dependency>

文件生成的目录

<build>
    		
    		<finalName>newboot</finalName>
    
    		
    		<resources>
    			<resource>
    				<directory>src/main/webapp</directory>
    				<targetPath>META-INF/resources</targetPath>
    				<includes>
    					<include>**/*.*</include>
    				</includes>
    			</resource>
    
    			
    			<resource>
    				<directory>src/main/java</directory>
    				<includes>
    					<include>**/*.xml</include>
    				</includes>
    			</resource>
    
    			
    			<resource>
    				<directory>src/main/resources</directory>
    				<includes>
    					<include>**/*.*</include>
    				</includes>
    			</resource>
    		</resources>
    		<plugins>
    			<plugin>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-maven-plugin</artifactId>
    			</plugin>
    		</plugins>
    	</build>

1.  重点是如果JDK是1.8的话使用SpringBoot3.0的话，也会报错，所以我这里用的是

<parent>
    	<groupId>org.springframework.boot</groupId>
    	<artifactId>spring-boot-starter-parent</artifactId>
    	<version>2.7.6</version>
    	<relativePath/> 
    </parent>

### 主要 ###

主要就是开发环境的各种版本和打包以后运行的版本要一致，打包成war的时候，一定要先使用独立的Tomcat在IDEA中运行一遍，并且记录一下Tomcat启动时候的各种配置IDE版本

打包成war之前一定要清理一下再重新打包  
![在这里插入图片描述][08b6c5c81b3b461e82396084f0889049.png]  
如果不清楚打包以后项目的名称可以使用jsp页面通过

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <title>index.jsp</title>
    </head>
    <body>
         <h3>项目的contextPath：${
        pageContext.request.contextPath}<h3/>
    </body>
    </html>

[b7cc1b72bce241e78c31109abda6e86c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/535eb9dde576403684562cff423cb521.png
[bc5bc74099824e1aa2b080b225f1d9ec.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/974906501d6444bea85ab295b9d016f3.png
[08b6c5c81b3b461e82396084f0889049.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/d7fb7b6f3d3246aca542ee0b20c40f95.png