Spring Boot中JSP视图复用菜单与页脚的实现方案咨询
2026-5-21
解决JSP菜单/页脚复用的几种实用方案
嘿，我完全懂你的痛点——复制粘贴30个文件的重复代码简直是噩梦，后续维护要疯！在Spring Boot的JSP项目里，你根本不用搞什么自定义变量替换，用JSP原生特性或者轻量级模板工具就能完美解决，下面给你几个最常用的方案：
方案1：静态包含（最适合纯静态的菜单/页脚）
这是最简单直接的方式，把菜单和页脚的代码单独抽成独立的JSP文件，然后在每个业务JSP里通过<%@ include %>引入。
步骤：
- 新建公共文件：比如在
/WEB-INF/views/commons/目录下创建menu.jsp和footer.jsp，把对应的菜单、页脚HTML代码放进去 - 在业务JSP中引入：
<body> <%@ include file="/WEB-INF/views/commons/menu.jsp" %> <!-- 这里是当前页面的业务内容 --> <div class="content">...</div> <%@ include file="/WEB-INF/views/commons/footer.jsp" %> </body>
优点：编译时就会把公共文件的代码合并到业务JSP里，性能好；修改menu.jsp后，所有引用的页面都会自动更新，完全符合你的需求。
方案2：动态包含（适合有动态逻辑的公共部分）
如果你的菜单需要展示动态内容（比如当前登录用户名、根据权限显示不同菜单），就用<jsp:include>标签，它是运行时引入公共文件的，还支持传递参数。
示例：
<body> <jsp:include page="/WEB-INF/views/commons/menu.jsp"> <!-- 可以传递参数给菜单页面 --> <jsp:param name="currentUser" value="${currentUser.username}" /> </jsp:include> <!-- 业务内容 --> <div class="content">...</div> <jsp:include page="/WEB-INF/views/commons/footer.jsp" /> </body>
在menu.jsp里可以通过${param.currentUser}获取传递的参数，实现动态渲染。
方案3：模板继承（更优雅的大型项目方案）
如果你的页面结构更复杂（比如除了菜单页脚，还有侧边栏、面包屑等），用模板继承会更优雅。推荐用Apache Tiles，它和Spring Boot集成很方便：
- 引入Tiles依赖（pom.xml）：
<dependency> <groupId>org.apache.tiles</groupId> <artifactId>tiles-extras</artifactId> <version>3.0.8</version> </dependency> <dependency> <groupId>org.apache.tiles</groupId> <artifactId>tiles-jsp</artifactId> <version>3.0.8</version> </dependency>
- 配置Tiles模板：创建
tiles.xml，定义基础模板和各个页面的布局：
<tiles-definitions> <definition name="base-layout" template="/WEB-INF/views/layouts/base.jsp"> <put-attribute name="menu" value="/WEB-INF/views/commons/menu.jsp" /> <put-attribute name="content" value="" /> <put-attribute name="footer" value="/WEB-INF/views/commons/footer.jsp" /> </definition> <definition name="home" extends="base-layout"> <put-attribute name="content" value="/WEB-INF/views/home.jsp" /> </definition> </tiles-definitions>
- 编写基础模板
base.jsp：
<body> <tiles:insertAttribute name="menu" /> <div class="content"> <tiles:insertAttribute name="content" /> </div> <tiles:insertAttribute name="footer" /> </body>
- 业务页面
home.jsp只需要写内容部分，不用管布局：
<h1>首页内容</h1> <p>这是首页的具体内容...</p>
这样所有页面都继承自base-layout，修改菜单或页脚只需要改对应的公共文件，完美实现复用。
注意事项（Spring Boot配置）
确保你的application.properties里配置了正确的JSP路径：
spring.mvc.view.prefix=/WEB-INF/views/ spring.mvc.view.suffix=.jsp
这样Spring才能正确找到你的JSP文件。
以上几种方案都能解决你的问题，个人推荐如果是简单的静态内容用方案1，有动态逻辑用方案2，大型项目用方案3，根据你的实际情况选就行！
内容的提问来源于stack exchange，提问作者Reage
