Spring Boot 默认不支持 JSP，需手动引入 Jasper 依赖并正确配置视图路径；关键在于 prefix 必须以 /WEB-INF/ 开头（而非 /webapp/WEB-INF/），且项目结构需符合传统 WAR 部署规范。
spring boot 默认不支持 jsp，需手动引入 jasper 依赖并正确配置视图路径；关键在于 prefix 必须以 `/web-inf/` 开头（而非 `/webapp/web-inf/`），且项目结构需符合传统 war 部署规范。
在 Spring Boot 项目中集成 JSP 是一个常见但易出错的需求。与传统的 Spring MVC 不同，Spring Boot 默认不支持 JSP 渲染，主要原因在于其内嵌 Tomcat 容器对 Jasper（JSP 编译引擎）的支持受限，且资源路径解析逻辑与标准 WAR 部署存在差异。
✅ 正确配置步骤
1. 确保项目结构符合 WAR 规范
JSP 文件必须放在 src/main/webapp/WEB-INF/views/ 目录下（注意：不是 src/main/resources 或 static）。例如：
src/ ├── main/ │ ├── java/ │ ├── resources/ │ └── webapp/ │ └── WEB-INF/ │ └── views/ │ └── hello.jsp ← 正确位置
⚠️ 注意：
webapp是 Web 资源根目录，Spring Boot 的ViewResolver在查找 JSP 时，会自动以ServletContext的根路径为基准——因此prefix中不应再包含/webapp。
2. 正确配置 application.properties
# ✅ 正确：以 /WEB-INF/ 开头，相对 ServletContext 根路径 spring.mvc.view.prefix=/WEB-INF/views/ spring.mvc.view.suffix=.jsp # 可选：启用调试日志定位问题 logging.level.org.springframework.web.servlet.ViewResolver=debug
❌ 错误示例（导致 404）：
spring.mvc.view.prefix=/webapp/WEB-INF/views/ # 多余的 /webapp → 路径不存在
3. 补全 Maven 依赖（关键！）
仅添加 tomcat-embed-jasper 不够，还需确保其作用域为 provided，并排除默认的 spring-boot-starter-tomcat 冲突（若打包为 WAR）：
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
<dependency><groupid>org.springframework.boot</groupid><artifactid>spring-boot-starter-web</artifactid><!-- 若打 WAR 包，需排除内嵌 Tomcat --><exclusions><exclusion><groupid>org.springframework.boot</groupid><artifactid>spring-boot-starter-tomcat</artifactid></exclusion></exclusions></dependency><!-- ✅ 必须：JSP 编译支持（provided，因运行时由容器提供） --><dependency><groupid>org.apache.tomcat.embed</groupid><artifactid>tomcat-embed-jasper</artifactid><scope>provided</scope></dependency><!-- ✅ 必须：JSTL 支持（如 JSP 中使用 <c:if> 等标签） --><dependency><groupid>javax.servlet</groupid><artifactid>jstl</artifactid></dependency>
? 提示：
tomcat-embed-jasper的provided作用域意味着它仅在编译和测试期生效，不打入最终包——因为实际运行时由外部 Tomcat（或内嵌容器的 Servlet API 实现）提供 Jasper。若误设为compile，反而可能引发类加载冲突。
4. 控制器写法保持简洁
@Controller
public class SayHelloController {
@RequestMapping("/hello")
public String hello() {
return "hello"; // 自动解析为 /WEB-INF/views/hello.jsp
}
}
无需 @ResponseBody（否则返回字符串文本而非视图），也无需手动指定扩展名。
? 常见错误排查清单
| 现象 | 原因 | 解决方案 |
|---|---|---|
Whitelabel Error Page + Resource not found
|
prefix 路径错误（如含 /webapp）或 JSP 文件未在 webapp/WEB-INF/views/ 下 |
检查路径层级，确认 hello.jsp 物理位置 |
HTTP Status 404 – Not Found 且日志显示 Path with "WEB-INF"
|
Spring Boot 尝试通过 FORWARD 转发但找不到资源 |
确认 spring.mvc.view.* 配置已生效（无拼写错误），且 @Controller 类被组件扫描到 |
| 页面显示原始 JSP 代码（未解析） |
tomcat-embed-jasper 缺失或作用域错误，或缺少 jstl
|
检查依赖是否引入、是否 provided、是否遗漏 jstl
|
启动时报 ClassNotFoundException: org.apache.jasper.servlet.JspServlet
|
tomcat-embed-jasper 未正确加载 |
清理 Maven 本地仓库并重载项目，或检查 IDE 是否识别 provided 依赖 |
✅ 总结
Spring Boot 对 JSP 的支持是“向后兼容”设计，并非首选方案（官方推荐 Thymeleaf/FreeMarker）。若必须使用 JSP，请严格遵循三点：
- ✅ 项目结构：
src/main/webapp/WEB-INF/views/xxx.jsp - ✅ 配置路径：
spring.mvc.view.prefix=/WEB-INF/views/（绝对不要加/webapp） - ✅ 依赖完备：
tomcat-embed-jasper（provided） +jstl
完成上述配置后，重启应用，访问 /hello 即可正确渲染 JSP 页面。
