SpringBoot3:ApplicationAvailability监控应用程序可用性状态[官方文档]

一、基本概念

Liveness(存活状态):应用是否正常运行(没崩溃、没死锁)
Readiness(就绪状态):应用是否准备好接收流量(初始化完成、依赖加载成功)
ApplicationAvailabilitySpring 提供的官方接口,用于获取 / 监听这两个状态

二、代码案例

利用监听器注解,在项目启动时,监听,通过ApplicationAvailability获取应用程序的可用性状态,并对应处理。

java 复制代码
package com.pzj.springboot3.demos.states;

import jakarta.annotation.Resource;
import org.springframework.boot.availability.ApplicationAvailability;
import org.springframework.boot.availability.AvailabilityChangeEvent;
import org.springframework.boot.availability.LivenessState;
import org.springframework.boot.availability.ReadinessState;
import org.springframework.context.event.EventListener;
import org.springframework.stereotype.Component;

/**
 * 自定义Bean,通过 ApplicationAvailability 获取应用可用性状态
 */
@Component
public class AppAvailabilityMonitor {

	// 1. 直接注入 Spring 提供的 ApplicationAvailability
	@Resource
	private ApplicationAvailability applicationAvailability;

	// ====================== 主动获取当前状态 ======================
	public void checkCurrentState() {
		// 获取存活状态(Liveness)
		LivenessState livenessState = applicationAvailability.getLivenessState();
		// 获取就绪状态(Readiness)
		ReadinessState readinessState = applicationAvailability.getReadinessState();

		System.out.println("当前应用存活状态:" + livenessState);
		System.out.println("当前应用就绪状态:" + readinessState);
	}

	// ====================== 监听状态变化(推荐) ======================
	/**
	 * 监听 存活状态(Liveness) 变化
	 */
	@EventListener
	public void onLivenessChange(AvailabilityChangeEvent<LivenessState> event) {
		LivenessState state = event.getState();
		System.out.println("【存活状态变更】:" + state);

		// 业务逻辑:比如应用挂了时告警、宕机时释放资源
		if (state == LivenessState.BROKEN) {
			System.err.println("应用异常,已停止服务!");
		}
	}

	/**
	 * 监听 就绪状态(Readiness) 变化
	 */
	@EventListener
	public void onReadinessChange(AvailabilityChangeEvent<ReadinessState> event) {
		ReadinessState state = event.getState();
		System.out.println("【就绪状态变更】:" + state);

		// 业务逻辑:应用就绪后初始化任务、加载缓存、注册服务
		if (state == ReadinessState.ACCEPTING_TRAFFIC) {
			System.out.println("应用已就绪,可以接收流量!");
			initBusinessTask();
		}
	}

	// 模拟业务初始化
	private void initBusinessTask() {
		System.out.println("执行业务初始化:加载配置、预热缓存...");
	}
}
相关推荐
plainGeekDev2 小时前
单例模式 → object 声明
android·java·kotlin
用户298698530143 小时前
Java 实现 Word 文档文本与图片提取的方法
java·后端
SimonKing3 小时前
铁子,IntelliJ IDEA 2026.1.3来了,升不升?
java·后端·程序员
咖啡八杯14 小时前
GoF设计模式——策略模式
java·后端·spring·设计模式
用户128526116021 天前
我把祖传Java项目重构后,接口响应从3s砍到了200ms,只改了这几行代码
java
Linsk1 天前
组件 = 模板 + 业务逻辑
java·前端·vue.js
星沉远浦1 天前
用Gemini高效解决Java代码报错难以定位的问题
java
用户298698530141 天前
Word 文档字符级格式化:Java 实现方案详解
java·后端
笨鸟飞不快1 天前
从单个服务到集群:一次完整的性能排查复盘
java·前端