正如摘要所述，本教程旨在帮助开发者在 Spring Boot 项目中正确配置和使用 JSP 视图技术。由于 Spring Boot 对 JSP 的支持存在一些限制，尤其是在使用嵌入式 Servlet 容器并打包为可执行 JAR 文件时，本文将详细介绍如何通过 WAR 打包方式来规避这些限制，并提供必要的配置步骤和注意事项，确保 JSP 能够正常工作。同时，也建议开发者在条件允许的情况下，考虑使用更现代化的模板引擎。

前提条件

在开始之前，请确保你已经安装了以下软件：

• JDK (Java Development Kit) 8 或更高版本
• Maven 或 Gradle 构建工具
• 一个 IDE，例如 IntelliJ IDEA 或 Eclipse

Spring Boot 中 JSP 的限制

Spring Boot 官方文档明确指出，在使用嵌入式 Servlet 容器（如 Tomcat 或 Jetty）并将应用程序打包为可执行 JAR 文件时，JSP 的支持存在一些限制。具体来说：

• WAR 打包是关键： 如果使用 Jetty 或 Tomcat，只有使用 war 打包方式才能保证 JSP 的正常工作。可执行的 WAR 文件可以通过 java -jar 命令启动，也可以部署到任何标准的 Servlet 容器中。
• JAR 包不支持 JSP： 当使用可执行 JAR 文件时，JSP 不被支持。
• Undertow 不支持 JSP： Undertow 嵌入式 Servlet 容器不支持 JSP。
• 自定义错误页面： 创建自定义的 error.jsp 页面并不能覆盖默认的错误处理视图。应使用自定义的错误页面配置来处理错误。

配置步骤

为了在 Spring Boot 中使用 JSP，你需要执行以下步骤：

1. 修改 pom.xml 或 build.gradle 文件：

   • Maven (pom.xml)：

     
        ...
        war
        ...
        
            
                org.apache.tomcat.embed
                tomcat-embed-jasper
                provided
            
            
                javax.servlet
                jstl
            
        
        ...
     

   • Gradle (build.gradle)：

     plugins {
        ...
        id 'war'
        ...
     }
     
     dependencies {
         providedRuntime 'org.springframework.boot:spring-boot-starter-tomcat'
         implementation 'javax.servlet:jstl'
     }

   将 packaging 设置为 war，并将 spring-boot-starter-tomcat 的 scope 设置为 provided，这意味着 Tomcat 容器将由外部提供，而不是打包到应用程序中。同时，添加 jstl 依赖，以便在 JSP 中使用 JSTL 标签库。

2. 配置视图解析器：

   在 application.properties 或 application.yml 文件中，配置视图解析器的前缀和后缀。这告诉 Spring Boot 在哪里查找 JSP 文件。

   spring.mvc.view.prefix=/WEB-INF/jsp/
   spring.mvc.view.suffix=.jsp

   这表示 JSP 文件应该位于 src/main/webapp/WEB-INF/jsp/ 目录下，并且文件扩展名为 .jsp。

3. 创建 JSP 目录：

   在 src/main/webapp/ 目录下创建 WEB-INF/jsp/ 目录。这是存放 JSP 文件的默认位置。

4. 创建 Controller：

   创建一个 Spring MVC Controller 来处理请求并返回 JSP 视图的名称。

   @Controller
   public class FirstController {
       @GetMapping("/")
       public String sayHello() {
           return "hello"; // 返回 JSP 视图的名称
       }
   }

5. 创建 JSP 文件：

   在 src/main/webapp/WEB-INF/jsp/ 目录下创建一个名为 hello.jsp 的文件。

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

示例代码

以下是一个完整的 Spring Boot 项目结构示例：

MyLibrary/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── lib/
│   │   │           └── secondtry/
│   │   │               ├── MyLibraryApplication.java
│   │   │               └── FirstController.java
│   │   ├── resources/
│   │   │   └── application.properties
│   │   └── webapp/
│   │       └── WEB-INF/
│   │           └── jsp/
│   │               └── hello.jsp
│   └── test/
│       └── java/
│           └── com/
│               └── lib/
│                   └── secondtry/
│                       └── MyLibraryApplicationTests.java
├── pom.xml

注意事项

• 确保你的 JSP 文件位于正确的目录下 (src/main/webapp/WEB-INF/jsp/)。
• 使用 WAR 打包方式。
• 检查 application.properties 或 application.yml 文件中的视图解析器配置是否正确。
• 如果遇到 404 错误，请检查你的 Controller 是否正确映射了请求路径。
• 尽量避免使用 JSP，可以考虑使用 Thymeleaf 或 FreeMarker 等更现代化的模板引擎。

总结

虽然 Spring Boot 对 JSP 的支持存在一些限制，但通过使用 WAR 打包方式，你可以成功地在 Spring Boot 项目中使用 JSP。 然而，考虑到 JSP 的局限性，建议在条件允许的情况下，选择更现代化的模板引擎，以便获得更好的开发体验和更高的性能。