You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot Admin UI「Web」选项显示控制及版本适配问题咨询

Spring Boot Admin「Web」菜单不显示问题的解决方案

刚好之前处理过类似的Spring Boot Admin和高版本微服务的兼容问题,我来给你拆解下原因和解决办法:

问题背景

在对接多个Spring Boot微服务到Spring Boot Admin时,发现左侧菜单的**「Web」选项**(包含Mappings和HTTP Traces子选项)仅在使用2.1.6.RELEASE版本Spring Boot Starter Parent的微服务中显示,而使用2.3.1.RELEASE等高版本的微服务则不显示。当前Spring Boot Admin Server版本为2.3.0(对应Parent版本2.3.1.RELEASE)。

核心原因

从Spring Boot 2.2.x版本开始,Actuator组件做了两处关键调整,直接影响Spring Boot Admin的UI显示:

  1. 端点默认暴露策略变更:mappings、httptrace这类端点不再默认对外暴露,Spring Boot Admin无法获取到这些端点的元数据,自然不会显示对应的菜单。
  2. HTTP Trace功能拆分:Spring Boot 2.3及以上版本中,httptrace端点的实现从spring-boot-starter-actuator核心依赖中拆分出来,需要单独引入依赖才能启用。

具体解决方案

1. 配置Actuator端点暴露

在不显示「Web」菜单的高版本微服务配置文件(application.yml或application.properties)中,明确开启并暴露需要的端点:

YAML格式:

management:
  endpoints:
    web:
      exposure:
        include: mappings, httptrace, health, info  # 可按需添加其他所需端点
  endpoint:
    httptrace:
      enabled: true

Properties格式:

management.endpoints.web.exposure.include=mappings,httptrace,health,info
management.endpoint.httptrace.enabled=true

2. 引入HTTP Trace依赖(针对Spring Boot 2.3+)

在高版本微服务的pom.xml中添加spring-boot-starter-httptrace依赖,确保httptrace端点能正常工作:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-httptrace</artifactId>
</dependency>

3. 保持版本兼容性

Spring Boot Admin Server与微服务的Spring Boot版本尽量保持大版本一致(比如Admin Server用2.3.x,微服务也优先用2.3.x系列)。如果微服务必须使用更高版本,建议同步升级Spring Boot Admin Server到对应兼容版本,避免跨大版本的兼容性问题。

验证方法

配置完成后重启微服务,直接访问微服务的/actuator/mappings和/actuator/httptrace端点,若能正常返回JSON格式的端点数据,说明配置生效,此时刷新Spring Boot Admin页面就能看到「Web」菜单了。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.09 19:27:40