You need to enable JavaScript to run this app. SpringBoot接口返回.jsp文件时浏览器直接下载而非渲染展示问题求助
优惠活动
大模型
产品
解决方案
定价
更多

SpringBoot接口返回.jsp文件时浏览器直接下载而非渲染展示问题求助

问题根因

Spring Boot默认未内置JSP解析支持,你当前缺少必要的JSP解析依赖、未配置视图解析器,导致Spring Boot将JSP文件识别为普通静态资源直接返回给浏览器,触发下载行为。

具体修改步骤
  • 第一步:调整pom.xml依赖
    删除pom.xml中原有的tomcat-jsp-api依赖,新增JSP解析所需的核心依赖:
<!-- 内嵌Tomcat的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>
  • 第二步:修正JSP存放路径
    将现有的src/main/WebApp文件夹重命名为全小写的src/main/webapp,部分操作系统大小写敏感,大写首字母会导致Spring Boot识别不到JSP资源。如果需要避免JSP文件被用户直接访问,可在src/main/webapp下新建WEB-INF/views目录,将Course.jsp移入该目录。
  • 第三步:配置视图解析器
    在src/main/resources目录下的application.properties文件中新增如下配置:
# 如果JSP直接放在webapp根目录,prefix填/;如果放在WEB-INF/views下则改为/WEB-INF/views/
spring.mvc.view.prefix=/
spring.mvc.view.suffix=.jsp
  • 第四步:调整Controller返回逻辑
    修改SpringController中的返回值,去掉.jsp后缀,由视图解析器自动拼接后缀:
@RequestMapping("/Courses")
public String cs() {
    return "Course";
}

所有修改完成后重启项目,访问/Courses接口即可正常渲染JSP页面。

额外注意事项
  • Spring Boot打Jar包运行时对JSP的支持存在限制,推荐优先打War包部署;如果必须打Jar包运行,需要在pom.xml的build节点下新增资源映射配置,将webapp目录下的资源打包进Jar包的META-INF/resources目录。
  • 当前Java类的包路径com.example.demo.com.example.demo存在重复嵌套,属于不规范写法,可调整为com.example.demo避免后续出现不必要的配置问题。

内容的提问来源于stack exchange,提问作者Ali

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 09:36:02