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
相关产品推荐
相关产品推荐

