You need to enable JavaScript to run this app. 如何切回spring-boot-admin 2.1.5版本的旧版登录页样式?
优惠活动
大模型
产品
解决方案
定价
更多

如何切回spring-boot-admin 2.1.5版本的旧版登录页样式?

适配Spring Boot Admin旧版登录页的实现方案

你可以通过资源覆盖的方式实现需求,不需要降级整体的SBA版本,具体操作如下:

  • 核心逻辑:Spring Boot 类路径资源的加载优先级遵循项目自定义资源 > 依赖jar内置资源的规则,把旧版登录页的相关文件放到项目的对应路径,即可自动覆盖新版默认的登录页。
  • 两个版本的登录页效果参考:
    2.1.5版本的旧版登录页:
    Image1
    2.3.1版本的新版登录页:
    Image2

具体操作步骤

  1. 提取2.1.5版本的登录页关联文件
    从2.1.5版本的spring-boot-admin-server-ui jar包中,导出所有和登录页相关的内容:
    • 页面模板:路径为templates/public/login.html的旧版登录页文件
    • 配套静态资源:登录页模板引用的CSS样式、背景图、品牌图标等静态文件,完全保留jar包内的原相对路径结构。
  2. 迁移文件到2.3.1版本的项目路径
    • 登录页模板放到项目的src/main/resources/templates/public/目录下,保持文件名login.html不变
    • 所有静态资源放到项目的src/main/resources/static/目录下,和jar包内的相对路径完全对齐。
  3. 做最小兼容性调整
    确认旧模板里的登录表单配置和2.3.1版本的安全逻辑匹配:
    • 保持表单提交地址为POST /login
    • 保留CSRF令牌的隐藏字段,确保字段名和新版Spring Security的配置一致,避免登录提交时报403权限错误。

关于现成模板的说明

目前没有单独抽离的旧版登录页独立组件可供直接引入,从2.1.5 jar包中提取的文件就是完整的可直接使用的模板——旧版登录页只包含Thymeleaf模板和对应CSS样式,没有复杂的前端交互逻辑,迁移后几乎不需要额外修改即可正常运行。

常见踩坑提示

  • 不要为了使用旧登录页直接替换整个SBA的UI依赖,新旧版本UI和服务端的接口交互逻辑存在差异,直接替换整个依赖会导致监控核心页面功能异常,仅替换登录页相关的模板和资源即可。
  • 如果调试时发现页面仍加载新版登录页,清理Spring Boot静态资源缓存、重启项目即可。
  • 确认Spring Security的放行规则覆盖自定义静态资源的访问路径,不要把自定义的CSS、图片拦在认证流程外。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.08 00:36:10