Spring MVC 支持多种模板技术，如 JSP、FreeMarker、Thymeleaf 等。Spring Boot 官方并不推荐使用 JSP 模板引擎，如果有可能，应尽量避免使用 JSP，因为当使用嵌入式 Servlet 容器时，对使用 JSP 模板引擎有几个已知的限制，以下是 Spring Boot 支持自动配置的模板引擎（其中并不包含 JSP）：

  • FreeMarker
  • Groovy
  • Thymeleaf
  • Mustache

在 pom.xml 配置文件中添加内嵌 Tomcat 容器依赖，scope 声明为 provided：

1
2
3
4
5
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

在 pom.xml 配置文件中添加 JSP 编译依赖，否则启动报错：

1
2
3
4
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
</dependency>

packaging 一定要声明为 war 类型，否则打包运行出错，完整配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.fanlychie</groupId>
    <artifactId>spring-boot-jsp-sample</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>spring-boot-jsp-sample</name>
    <url>http://maven.apache.org</url>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.2.RELEASE</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

1. 控制器

1
2
3
4
5
6
7
8
9
10
@Controller
public class WelcomeController {
    
    @GetMapping("/")
    public String welcome(ModelMap model) {
        model.put("message", "Hello JSP!");
        return "index";
    }
    
}

2. 主应用程序类

1
2
3
4
5
6
7
8
@SpringBootApplication
public class Application {
    
    public static void main(String[] args) {
        SpringApplication.run(Application.class);
    }
    
}

3. 配置文件

在 Spring Boot 中使用 JSP 模板引擎有几个已知的限制，Spring Boot 对 JSP 模板引擎没有提供自动配置的支持，你需要手工配置视图模板文件信息。application.yml 配置示例：

1
2
3
4
5
6
7
spring:
  main:
    banner-mode: 'off'
  mvc:
    view:
      prefix: /WEB-INF/pages/
      suffix: .jsp

4. 模板文件

src/main/webapp/WEB-INF/pages/index.jsp

1
2
3
4
5
6
7
8
9
10
<%@ page pageEncoding="UTF-8" %>
<html>
<head>
    <title>欢迎页</title>
    <link href="/css/main.css" rel="stylesheet" />
</head>
<body>
    <h1>${message}</h1>
</body>
</html>

5. 静态文件

Spring Boot 默认将静态资源文件映射到类路径下的目录包括（详见 ResourcesProperties）：

  • /META-INF/resources/
  • /resources/
  • /static/
  • /public/

因此我们可以将 css、js、images 等静态资源文件放在/src/main/resources/static/目录下。

# src/main/resources/static/css/main.css


1
2
3
4
5
6
7
8
9
body {
    padding: 0;
    color: #444;
    width: 280px;
    margin: 100px auto;
    font-family: SimSun;
    background-color: #FBFBFB;
    text-shadow: rgba(50,50,50,0.3) 2px 2px 3px;
}

6. 模板文件和静态资源文件的缓存问题

当修改 css、js 等静态资源文件的内容或模板文件的内容时，刷新客户端浏览器，发现内容还是老的，说明 Spring Boot 内置的 Servelt 容器并没有实时重新加载修改过的文件内容。你只能在每次修改静态资源文件时，虽然不需要重启服务，但是你要重新编译一次，IntelliJ IDEA 中按一次 Ctrl + F9 即可。
实现热加载（live reload）可参考：解决 IntelliJ IDEA 无法热加载 Spring Boot 模板文件和静态资源文件

示例项目开发环境：Java-8、Maven-3、IntelliJ IDEA-2017、Spring Boot-1.5.2.RELEASE
完整示例项目链接：spring-boot-jsp-sample