云环境下Spring Boot Vaadin服务就绪状态检测问题咨询

问题根因 #

Spring Boot 自带的Actuator默认健康检测仅校验Spring上下文加载完成、内置容器启动、依赖中间件（如数据库、缓存）可用等核心状态，不会覆盖Vaadin的路由注册、UI组件初始化、静态资源映射等专属初始化逻辑，因此会出现health接口返回UP但Vaadin仍未就绪的问题。

可行解决方案 #

方案1：自定义Actuator就绪健康指示器（推荐） #

该方案可以直接复用负载均衡原有对接Actuator健康检测的逻辑，无需调整负载均衡侧的配置规则。

• 第一步：定义Vaadin初始化状态持有组件

@Component
public class VaadinInitStatus {
    private volatile boolean initialized = false;

    public void markInitialized() {
        this.initialized = true;
    }

    public boolean isInitialized() {
        return initialized;
    }
}

• 第二步：实现Vaadin初始化监听器，监听服务初始化完成事件

@Component
public class CustomVaadinServiceInitListener implements VaadinServiceInitListener {
    private final VaadinInitStatus vaadinInitStatus;

    public CustomVaadinServiceInitListener(VaadinInitStatus vaadinInitStatus) {
        this.vaadinInitStatus = vaadinInitStatus;
    }

    @Override
    public void serviceInit(ServiceInitEvent event) {
        // Vaadin服务所有初始化逻辑完成后触发该方法，标记就绪状态
        vaadinInitStatus.markInitialized();
    }
}

• 第三步：自定义健康指示器，将Vaadin状态纳入就绪检测

@Component
public class VaadinHealthIndicator implements HealthIndicator {
    private final VaadinInitStatus vaadinInitStatus;

    public VaadinHealthIndicator(VaadinInitStatus vaadinInitStatus) {
        this.vaadinInitStatus = vaadinInitStatus;
    }

    @Override
    public Health health() {
        if (vaadinInitStatus.isInitialized()) {
            return Health.up().withDetail("vaadin", "初始化完成").build();
        }
        return Health.down().withDetail("vaadin", "未完成初始化").build();
    }
}

• 第四步：配置就绪检测组，将自定义Vaadin健康检查加入检测项，在application.yml中添加如下配置：

management:
  endpoint:
    health:
      group:
        readiness:
          include: vaadin
      show-components: always

配置完成后，负载均衡侧将原有的/actuator/health检测地址替换为/actuator/health/readiness即可，只有Vaadin完全初始化完成后，该接口才会返回UP状态。

方案2：负载均衡直接检测Vaadin入口路由（无需改代码） #

如果不想调整业务代码，可以直接让负载均衡发送GET请求检测Vaadin的公开入口路由（如首页/、登录页/login等），校验返回的HTTP状态码是否为200即可，该方案无需修改应用代码，直接调整负载均衡配置即可生效。

注意事项 #

• 如果应用有权限拦截逻辑，需要将健康检测路径或者负载均衡的健康检查请求放行，避免被权限框架拦截导致检测失败。
• 若使用K8s编排，直接将上述就绪检测地址配置为readinessProbe的检测地址即可，不影响原有粘性会话的负载均衡逻辑。

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