SpringBoot如何在项目中使用JSP

发布时间：2021-07-07 17:44:38 作者：chen
来源：亿速云阅读：325

# SpringBoot如何在项目中使用JSP

## 前言

SpringBoot作为当下最流行的Java开发框架，其"约定优于配置"的理念极大地简化了Spring应用的初始搭建和开发过程。然而在视图技术选择上，虽然Thymeleaf、FreeMarker等模板引擎已成为官方推荐方案，但仍有大量传统项目需要集成JSP（JavaServer Pages）进行页面渲染。本文将详细介绍在SpringBoot项目中整合JSP的全过程，涵盖从环境配置到实际开发的完整解决方案。

## 一、JSP与SpringBoot的兼容性说明

### 1.1 官方态度
SpringBoot官方文档中明确指出：
> "JSPs should be avoided if possible"

主要原因包括：
- 内嵌Servlet容器（Tomcat/Jetty）对JSP支持有限
- 打包为可执行JAR时存在路径问题
- WAR部署方式才能获得完整JSP功能

### 1.2 典型使用场景
仍需要考虑使用JSP的情况：
- 遗留系统迁移
- 团队技术栈过渡期
- 特定第三方组件依赖

## 二、项目初始化配置

### 2.1 创建项目结构
推荐使用Maven的war打包方式：
```xml
<packaging>war</packaging>

2.2 关键依赖配置

pom.xml需包含：

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </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>
</dependencies>

三、目录结构规范

3.1 标准项目布局

src/
├── main/
│   ├── java/
│   ├── resources/
│   └── webapp/
│       ├── WEB-INF/
│       │   └── views/  # JSP存放目录
│       └── static/     # 静态资源

3.2 配置视图解析器

application.properties中配置：

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

或Java配置方式：

@Configuration
public class MvcConfig implements WebMvcConfigurer {
    @Bean
    public ViewResolver jspViewResolver() {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/views/");
        resolver.setSuffix(".jsp");
        return resolver;
    }
}

四、开发实践示例

4.1 基础控制器

@Controller
@RequestMapping("/products")
public class ProductController {
    
    @GetMapping
    public String listProducts(Model model) {
        model.addAttribute("products", productService.findAll());
        return "product/list"; // 对应/WEB-INF/views/product/list.jsp
    }
}

4.2 JSP页面示例

/WEB-INF/views/product/list.jsp:

<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
<head>
    <title>产品列表</title>
</head>
<body>
    <h2>产品清单</h2>
    <table>
        <c:forEach items="${products}" var="product">
            <tr>
                <td>${product.id}</td>
                <td>${product.name}</td>
            </tr>
        </c:forEach>
    </table>
</body>
</html>

五、高级配置技巧

5.1 静态资源处理

配置资源映射避免冲突：

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/static/**")
            .addResourceLocations("classpath:/static/");
}

5.2 自定义错误页面

通过JSP实现错误页面： 1. 创建/WEB-INF/views/error/404.jsp 2. 配置异常处理：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(ResourceNotFoundException.class)
    public String handle404() {
        return "error/404";
    }
}

六、部署注意事项

6.1 内嵌容器部署

需特殊处理JSP编译：

@SpringBootApplication
public class Application extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(Application.class);
    }
}

6.2 外部Tomcat部署

需确保： 1. 打包为WAR文件 2. 排除内嵌Tomcat：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

七、常见问题解决方案

7.1 JSP不生效排查步骤

检查依赖是否完整
验证目录结构是否符合规范
查看控制台是否有编译错误
确认视图解析器配置

7.2 性能优化建议

预编译JSP：在构建阶段使用jspc-maven-plugin
启用缓存：server.servlet.jsp.init-parameters.development=false
合理使用静态化技术

八、替代方案对比

特性	JSP	Thymeleaf	FreeMarker
学习曲线	低	中	中
性能	一般	优秀	优秀
天然模板	否	是	是
静态检查	有限	强大	中等

结语

虽然SpringBoot官方更推荐使用现代模板引擎，但在实际企业应用中，JSP因其历史积累和开发者的熟悉程度，仍然有其存在的价值。通过本文的详细指导，开发者可以顺利完成SpringBoot与JSP的整合，实现传统技术向现代框架的平稳过渡。建议新项目优先考虑Thymeleaf等替代方案，而对于遗留系统改造，本文提供的方案无疑是最佳实践。

注意：本文基于SpringBoot 2.7.x版本编写，不同版本可能存在细微差异 “`

这篇文章包含了约2800字，采用Markdown格式编写，覆盖了从基础配置到高级应用的完整内容，并包含代码示例、配置片段和对比表格等实用元素。文章结构清晰，适合作为技术文档参考。