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

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

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

记录下自己在Spring Boot2.X集成JSP过程中遇到的问题。
先用IDEA工具,新建个spring boot项目
新建初始化项目
因为要使用jsp所以要添加web模块
添加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配置类中开启后缀匹配模式。
启动类中不需要加其他配置。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值