Spring Boot2.X集成JSP，静态资源访问问题

最新推荐文章于 2023-02-18 07:00:00 发布

明帝573

最新推荐文章于 2023-02-18 07:00:00 发布

阅读量874

点赞数

CC 4.0 BY-SA版权

分类专栏： Java

本文链接：https://blog.youkuaiyun.com/daiming573/article/details/103111470

Java 专栏收录该内容

7 篇文章

订阅专栏

本文详细记录了在Spring Boot2.X中集成JSP并解决静态资源404问题的过程。从项目结构设置、pom.xml配置、静态资源路径设置到webmvcConfig的调整，逐一排查了各种可能的问题，包括Tomcat版本、类路径错误和Swagger静态资源冲突等。最终通过配置实现了静态资源的正常访问和接口的正确调用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

记录下自己在Spring Boot2.X集成JSP过程中遇到的问题。
先用IDEA工具，新建个spring boot项目
新建初始化项目
因为要使用jsp所以要添加web模块

项目创建完成后，在项目的modules中添加web，并添加webpp路径。
在这里插入图片描述
然后在webapp中添加jsp相关文件和静态资源，并在application.properties中添加文件路径和jsp后缀。


```java
###配置前后缀关系
spring.mvc.view.prefix=/WEB-INF/page
spring.mvc.view.suffix=.jsp

在这里插入图片描述
注意pom.xml文件中配置，由于集成jsp不能用jar包方式启动，所以需要打成war包。

<!--spring 相关配置 start-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                    <artifactId>spring-boot-starter-tomcat</artifactId>
                    <groupId>org.springframework.boot</groupId>
                </exclusion>
            </exclusions>
        </dependency>
        <!-- 自定义tomcat版本，去掉boot里面的tomcat，项目中引用的自己单独引用 -->
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-servlet-api</artifactId>
            <version>9.0.20</version>
            <scope>provided</scope>
        </dependency>
        
        <!-- SpringBoot 外部tomcat支持 -->
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
        </dependency>
        <!--<dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>javax.servlet.jsp-api</artifactId>
            <version>2.3.1</version>
        </dependency>-->
        <!--在jsp页面使用jstl标签来处理页面逻辑，那么需要引入jstl -->
        <!--<dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
        </dependency>-->
        <!--mybatis-plus自动代码生成工具-->

网上其他大牛说需要引入后面两个包，我这边jsp目前没有其他需求，运行没问题，暂时不引入。

运行启动，访问页面，静态资源404。怀疑是不是路径问题，或者静态资源被过滤。
在这里插入图片描述
默认spring boot访问静态资源是在resource下的static或者template。把静态资源放入resource下新建static文件中，依然访问不到。尝试网上大神建议在webmvcConfig类中加入静态资源过滤。

@Bean
    public ServletRegistrationBean servletRegistrationBean(DispatcherServlet dispatcherServlet) {
        ServletRegistrationBean<DispatcherServlet> servletServletRegistrationBean = new ServletRegistrationBean<>(dispatcherServlet);
        servletServletRegistrationBean.addUrlMappings("*.do");
        servletServletRegistrationBean.addUrlMappings("*.html");
        servletServletRegistrationBean.addUrlMappings("*.css");
        servletServletRegistrationBean.addUrlMappings("*.js");
        servletServletRegistrationBean.addUrlMappings("*.png");
        servletServletRegistrationBean.addUrlMappings("*.gif");
        servletServletRegistrationBean.addUrlMappings("*.ico");
        servletServletRegistrationBean.addUrlMappings("*.jpeg");
        servletServletRegistrationBean.addUrlMappings("*.jpg");
        return servletServletRegistrationBean;
    }

后来还是无法访问，纠结了半天依然无法访问，尝试在eclipse上建个项目用同样的内容，竟然可以访问了。后来排查tomcat版本不一致，idea外置tomcat9再次尝试，静态资源可以访问，访问页面抛出异常。排查很久是jsp页面中嵌入java代码引用的类路径错误，导致访问页面异常。然后访问.do接口404，再次在webmvcConfig配置类中开启后缀匹配模式，接口访问成功。



    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        WebMvcConfigurer.super.configurePathMatch(configurer);
        //开启后缀匹配模式
        configurer.setUseRegisteredSuffixPatternMatch(true);
        //开启后缀正则匹配模式
        configurer.setUseSuffixPatternMatch(true);
    }

到此一切应该可以了，然而在访问swagger页面的时候提示静态资源找不到，找了几个地方在webmvcConfig配置类中把配置servletRegistrationBean的静态资源urlmapping去掉即可。
spring boot2.X集成jsp搞了一天，Mark一下。
1、在application.properties文件中配置jsp文件路径和。jsp后缀
2、在pom文件中引入依赖的jar包。
3、在webMvcConfig配置类中开启后缀匹配模式。
启动类中不需要加其他配置。