Spring Boot响应式WebFlux应用Actuator端点404无法访问问题咨询
WebFlux 应用 Actuator 端点404排查步骤
1. 优先处理依赖版本冲突问题
你当前的依赖配置存在版本管控混乱的问题:
- 你单独显式声明了
spring-context、spring-webflux、reactor-netty的自定义版本,这些版本会覆盖Spring Boot Starter默认管理的兼容版本,直接打断Spring Boot自动配置的类版本校验逻辑,导致Actuator相关自动配置类被跳过,自然不会注册任何端点,日志也不会有端点加载的相关记录。 - 你引入的
reactor-netty 0.9.1.RELEASE仅兼容Spring Boot 2.2.x及更早版本,如果当前项目使用的Spring Boot版本高于该版本,会直接导致WebFlux路由映射逻辑初始化异常,无法关联到Actuator端点。
修复方式:移除所有显式声明的
spring-context、spring-webflux、reactor-netty依赖,完全交由Spring Boot的依赖管理机制统一管控版本,消除版本冲突。
2. 修正端点路径与暴露规则
Spring Boot 2.x版本的Actuator默认规则和你预期的访问路径不匹配:
- Actuator端点的默认基础路径是
/actuator,且默认仅暴露health、info两个端点,直接访问http://127.0.0.1:8081/health必然返回404,默认可正常访问的健康检查地址是http://127.0.0.1:8081/actuator/health。 - 如果你确实需要在根路径直接访问
/health,需要在application.properties/application.yml中增加配置:
# 将Actuator基础路径调整为应用根路径 management.endpoints.web.base-path=/ # 显式开启健康检查端点的Web暴露 management.endpoints.web.exposure.include=health
3. 放行Security拦截规则
你项目引入了spring-boot-starter-security,响应式Security默认会拦截所有请求做权限校验,如果未对Actuator路径做放行配置,会导致请求被路由到认证逻辑分支,甚至因为权限匹配异常返回404。
修复方式:在响应式Security配置类中,对Actuator相关路径设置放行权限,示例代码:
@Bean public SecurityWebFilterChain securityWebFilterChain(ServerHttpSecurity http) { return http .authorizeExchange() .pathMatchers("/actuator/**", "/health").permitAll() .anyExchange().authenticated() .and() .build(); }
4. 定位自动配置加载异常原因
如果以上调整后仍无法正常加载端点,可开启自动配置调试日志,定位Actuator自动配置未生效的具体原因:
在配置文件中增加日志级别配置:
logging.level.org.springframework.boot.autoconfigure=DEBUG
启动应用后在日志中搜索EndpointAutoConfiguration、HealthEndpointAutoConfiguration、WebFluxEndpointManagementContextConfiguration相关记录,即可看到自动配置类被跳过的具体原因。
内容的提问来源于stack exchange,提问作者Tejpal Borkar
相关产品推荐
相关产品推荐

