使用Spring MVC及JSP在首页展示维护通知横幅的最佳实现方案咨询

以下是经过生产环境验证的可行实现方案，覆盖你需要的自动加载、复用能力需求：

1. 已开发横幅JSP的复用方案 #

你已经完成横幅JSP开发的前提下，优先用JSP引入能力复用片段，避免重复编码：

• 静态引入：如果横幅不需要每次加载都调用后端接口判断状态，直接在首页JSP顶部添加<%@ include file="/WEB-INF/jsp/fragment/maintenance-banner.jsp" %>即可，引入的片段会和首页JSP合并编译，性能最优
• 动态引入：如果横幅需要动态获取后端配置的通知内容、生效状态，用<jsp:include page="/api/maintenance/banner/render" />，对应路径是Spring MVC提供的接口，会在页面渲染时自动调用接口返回横幅的渲染结果

2. 首页自动触发加载的实现 #

两种可选方案，根据业务场景选择：

方案A：同步注入（适合低频次更新的通知） #

• 新增Spring MVC拦截器MaintenanceBannerInterceptor，实现HandlerInterceptor接口，在preHandle或者postHandle方法中查询维护通知的启用状态、内容、生效时间范围，判断当前是否需要展示横幅，将结果存入request属性中
• 配置拦截器规则，仅拦截首页（或者所有需要展示横幅的页面）的请求，无需修改现有首页的Controller逻辑
• 你开发的横幅JSP片段中直接读取request中的横幅配置，判断如果是启用状态则渲染对应内容，否则不渲染DOM节点

方案B：异步加载（适合高频更新、不希望影响首页加载速度的场景） #

• 首页预留横幅占位容器：<div id="maintenance-banner-container" style="display:none"></div>
• 新增Spring MVC接口GET /api/maintenance/banner/info，返回JSON格式的横幅状态、内容数据，接口上添加@Cacheable注解缓存结果，降低服务压力
• 首页添加JS逻辑，页面DOM加载完成后自动调用接口：

document.addEventListener('DOMContentLoaded', function() {
  fetch('/api/maintenance/banner/info')
    .then(res => res.json())
    .then(data => {
      if (data.enable) {
        const bannerContainer = document.getElementById('maintenance-banner-container');
        // 直接插入你开发的横幅HTML内容，或者调用渲染逻辑
        bannerContainer.innerHTML = data.content;
        bannerContainer.style.display = 'block';
      }
    })
    .catch(err => {
      // 接口异常时忽略，不影响首页正常展示
      console.warn('维护横幅加载失败', err);
    });
});

3. 优化建议 #

• 通知配置可以存在配置文件、数据库或者配置中心中，无需修改代码即可上下线维护通知
• 横幅添加手动关闭按钮，用户关闭后将状态存入浏览器localStorage，24小时内不再重复弹出，降低对用户的打扰
• 若存在多环境差异，可以通过Spring Profile配置不同环境的横幅默认展示规则，避免测试环境的通知带到生产环境

内容的提问来源于stack exchange，提问作者kaushik gopu