SpringBoot项目如何整合JSP

发布时间：2022-09-26 11:12:40 作者：iii
来源：亿速云阅读：188

# SpringBoot项目如何整合JSP

## 前言
SpringBoot默认推荐使用Thymeleaf等模板引擎，但在某些遗留项目或特定需求场景下，仍需整合传统的JSP（JavaServer Pages）。本文将详细介绍如何在SpringBoot 2.x项目中整合JSP视图技术。

---

## 一、环境准备
### 1. 创建项目
通过Spring Initializr创建项目时需注意：
```xml
<!-- 必须选择War包打包方式 -->
<packaging>war</packaging>

2. 添加必要依赖

<!-- servlet依赖 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <scope>provided</scope>
</dependency>

<!-- JSP支持依赖 -->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
    <scope>provided</scope>
</dependency>

<!-- JSTL标签库（可选） -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
</dependency>

二、项目配置

1. 配置文件设置

在application.properties中添加：

# 视图前缀和后缀
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp

# 开发时关闭缓存
spring.jsp.servlet.init-parameters.development=true

2. 目录结构规范

必须手动创建以下目录：

src
└── main
    ├── java
    ├── resources
    └── webapp
        └── WEB-INF
            └── views  # JSP存放目录

三、核心实现步骤

1. 控制器编写

@Controller
public class DemoController {
    
    @GetMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("message", "Hello JSP!");
        return "demo"; // 对应/WEB-INF/views/demo.jsp
    }
}

2. JSP页面示例

/WEB-INF/views/demo.jsp：

<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<html>
<head>
    <title>Demo</title>
</head>
<body>
    <h1>${message}</h1>
    <c:if test="${not empty message}">
        <p>Message exists!</p>
    </c:if>
</body>
</html>

四、常见问题解决方案

1. 404页面找不到

检查spring.mvc.view.prefix配置
确认JSP文件是否放在webapp/WEB-INF下
清理IDE缓存后重启项目

2. JSTL标签失效

确保依赖正确且添加了：

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

3. 热部署配置

在IDEA中： 1. 打开Run/Debug Configurations 2. 勾选Build project automatically 3. 添加compiler.automake.allow.when.app.running注册表项

五、注意事项

打包差异：需使用mvn package生成war包部署到外部Tomcat
版本兼容：
- SpringBoot 2.7.x+需要JSP 2.3+
- 避免与Thymeleaf同时使用
性能建议：
- 生产环境应预编译JSP
- 考虑使用spring-boot-starter-tomcat替代嵌入式容器

结语

虽然现代项目更推荐使用Thymeleaf/Vue等前后端分离方案，但在特定场景下整合JSP仍有其价值。通过本文的配置指南，开发者可以快速实现SpringBoot与JSP的整合。建议新项目优先考虑更现代的视图技术，老项目迁移时可参考此方案逐步重构。 “`

注：实际使用时请根据SpringBoot版本调整依赖版本号，本文示例基于SpringBoot 2.7.x版本编写。