在 Spring Boot 中使用 JSP 的完整指南_技术教程

在 Spring Boot 项目中，使用 JSP 技术可能遇到一些配置和限制问题，特别是与内嵌 Servlet 容器相关。本文档旨在帮助开发者正确配置 Maven 项目，设置必要的属性，并解决常见的 JSP 相关问题。同时，也建议开发者考虑使用更现代化的模板引擎以获得更好的开发体验。

Spring Boot 中 JSP 的配置

在 S

pring Boot 中使用 JSP，需要进行一些配置才能正常工作。以下步骤将引导你完成配置过程。

修改 pom.xml 文件

首先，需要将项目的打包方式从 jar 修改为 war。这是因为 Spring Boot 内嵌 Servlet 容器（如 Tomcat 或 Jetty）对 JSP 的支持在 war 打包方式下更好。

在 pom.xml 文件中，添加或修改标签：
```
    ...
    war
    ...
```
添加必要的依赖

确保 pom.xml 文件中包含以下依赖项，这些依赖项对于 JSP 的编译和运行至关重要：
```
    org.apache.tomcat.embed
    tomcat-embed-jasper


    javax.servlet
    jstl
```
请注意，tomcat-embed-jasper 依赖通常应该具有 provided 作用域，尤其是在部署到外部容器时。
```
    org.springframework.boot
    spring-boot-starter-tomcat
    provided
```
配置 JSP 视图解析器

在 application.properties 或 application.yml 文件中，配置 Spring MVC 的视图解析器，指定 JSP 文件的位置和后缀名：
```
spring.mvc.view.prefix=/webapp/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp
```
这里，spring.mvc.view.prefix 指定了 JSP 文件存放的目录，spring.mvc.view.suffix 指定了 JSP 文件的后缀名。
创建 JSP 文件目录

根据 spring.mvc.view.prefix 配置的路径，创建相应的目录结构。通常，JSP 文件应该放在 src/main/webapp/WEB-INF/jsp/ 目录下。确保 webapp 目录位于 src/main 目录下。

编写 Controller

创建一个 Spring MVC Controller，用于处理请求并返回 JSP 视图：

@Controller
public class FirstController {
    @GetMapping("/")
    public String sayHello() {
        return "hello"; // 返回的视图名称，对应 /webapp/WEB-INF/jsp/hello.jsp
    }
}

创建 JSP 视图文件

在 src/main/webapp/WEB-INF/jsp/ 目录下创建一个名为 hello.jsp 的文件，内容如下：
```
<%@ page contentType="text/html;charset=UTF-8" language="java" %>


    Hello JSP


    Hello, World!
```

注意事项和限制

内嵌 Servlet 容器的限制

当 Spring Boot 应用使用内嵌 Servlet 容器并打包成可执行的 jar 文件时，JSP 的支持会受到限制。官方文档建议使用 war 打包方式来解决这个问题。
Undertow 不支持 JSP

如果使用 Undertow 作为内嵌 Servlet 容器，则不支持 JSP。
自定义错误页面

创建自定义的 error.jsp 页面可能无法覆盖默认的错误处理视图。建议使用自定义错误页面来处理错误。