SpringBoot 添加对JSP的支持（附常见坑点）

序言：
SpringBoot默认不支持JSP，如果想在项目中使用，需要进行相关初始化工作。为了方便大家更好的开发，本案例可直接作为JSP开发的脚手架工程 SpringBoot+War+JSP .

常见问题：
1.修改JSP需重启才能生效:
在生产环境中，SpringBoot重新编译JSP可能会导致较大的性能损失，并且很难追查到问题根源，所以在最新的版本中，官方已经默认关闭此功能，详见JspServlet类的初始化参数。那么，如何解决这个问题呢？推荐两个解决办法：1.使用devtools 2. 添加配置（server.servlet.jsp.init-parameters.development=true）
2.如何避免各种404：
1.导入Tomcat+JASPER+JSTL 2.必须创建webapp目录 3.推荐使用外置Tomcat

正文：SpringBoot 添加对JSP的支持

1. 搭建脚手架

首先使用 Spring Initializr 构建工程，选择war类型进行构建，整体结构图如下：

项目结构图

2. 在pom.xml 添加相关依赖

  


    
    4.0.0
    com.hehe
    springboot-web-jsp
    0.0.1-SNAPSHOT

    
    war

    
    
        org.springframework.boot
        spring-boot-starter-parent
        2.0.0.M4
        
    

    
    
        
            org.springframework.boot
            spring-boot-starter-web
        
        
            org.springframework.boot
            spring-boot-starter-tomcat
        
        
            org.apache.tomcat.embed
            tomcat-embed-jasper
        
        
            javax.servlet
            jstl
        
        
            org.springframework.boot
            spring-boot-devtools
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        
    

    
    
        
            spring-snapshots
            http://repo.spring.io/snapshot
            true
        
        
            spring-milestones
            http://repo.spring.io/milestone
        
    
    
        
            spring-snapshots
            http://repo.spring.io/snapshot
        
        
            spring-milestones
            http://repo.spring.io/milestone
        
    

    
    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

3. 启动类添加Servlet支持

@SpringBootApplication
public class SpringbootWarJspApplication extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(SpringbootWarJspApplication.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(SpringbootWarJspApplication.class, args);
    }
}

4. 添加MVC映射

application.yml 配置如下：

spring:
  mvc:
    view:
      prefix: /WEB-INF/views/  # Read From Web Resources Dir
      suffix: .jsp

5. 编写JSP页面

在 WEB-INF/views 目录下新建一个JSP文件

<%@ page contentType="text/html;charset=UTF-8" language="java" %>



  
Hello JSP !!
      ![](${pageContext.servletContext.contextPath}/doge.gif)
  

6.启动项目

启动方式1：在IDE启动WebJspApplication，然后打开项目地址。

启动方式2：部署到外置Tomcat，启动完成后，打开项目地址。这里需要注意的是，使用外置Tomcat部署的时候，需要将嵌入式容器调整为provided级别。（防止冲突）

       
            org.springframework.boot
            spring-boot-starter-tomcat
            provided
        
        
            org.apache.tomcat.embed
            tomcat-embed-jasper
            provided
        

7.单元测试

@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
@DirtiesContext
public class WebJspApplicationTest {

    @Autowired
    private TestRestTemplate restTemplate;

    @Test
    public void testJspWithEl() throws Exception {
        ResponseEntity entity = restTemplate.getForEntity("/", String.class);
        assertThat(entity.getStatusCode()).isEqualTo(HttpStatus.OK);
        assertThat(entity.getBody()).contains("Hello JSP");
    }

}

全文至此，有疑问的小伙伴可在评论下方进行交流。