You need to enable JavaScript to run this app. Spring Boot响应式WebFlux应用Actuator端点404无法访问问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.18 00:36:02