如何解决Spring Boot环境下Hazelcast实例无法优雅关闭的问题？

问题根因 #

你遇到的现象是Hazelcast的shutdown逻辑执行时机晚于Spring上下文资源销毁，导致Hazelcast还未向集群广播下线通知、更新节点状态，网络、线程池等依赖资源已经被Spring释放，无法完成正常的主动下线流程，只能靠其他节点的心跳超时判断节点退出。

修复配置步骤 #

1. 调整Hazelcast销毁顺序，优先执行下线逻辑 #

如果是自定义注册Hazelcast实例，通过@Bean的destroyMethod和@Order指定最高优先级销毁：

@Bean(destroyMethod = "shutdown")
@Order(Ordered.HIGHEST_PRECEDENCE)
public HazelcastInstance hazelcastInstance() {
    Config config = new Config();
    // 原有Hazelcast配置逻辑
    return Hazelcast.newHazelcastInstance(config);
}

如果使用Spring Boot自动装配的Hazelcast实例，通过实现SmartLifecycle指定销毁优先级：

@Component
public class HazelcastGracefulShutdown implements SmartLifecycle {
    private final HazelcastInstance hazelcastInstance;

    public HazelcastGracefulShutdown(HazelcastInstance hazelcastInstance) {
        this.hazelcastInstance = hazelcastInstance;
    }

    @Override
    public void stop() {
        hazelcastInstance.shutdown();
    }

    @Override
    public int getPhase() {
        // 最小数值代表最高销毁优先级，早于所有Spring内置bean销毁
        return Integer.MIN_VALUE;
    }

    // 以下为默认实现即可
    @Override
    public void start() {}
    @Override
    public boolean isRunning() {return true;}
    @Override
    public boolean isAutoStartup() {return true;}
    @Override
    public void stop(Runnable callback) {
        stop();
        callback.run();
    }
}

2. 开启Hazelcast优雅关闭参数 #

在配置中添加以下参数，显式开启优雅关闭，禁用自带的shutdown钩子避免和Spring的生命周期冲突：

YAML配置示例

hazelcast:
  shutdown:
    graceful:
      enabled: true
      wait-seconds: 30 # 可根据业务数据迁移需要调整超时时间
  shutdownhook:
    enabled: false # 禁用Hazelcast自带的关闭钩子，交给Spring管理
  network:
    failure-detector:
      icmp:
        enabled: true # 开启ICMP失败检测，辅助集群快速感知节点状态变化

代码配置示例

config.setProperty("hazelcast.shutdown.graceful.enabled", "true");
config.setProperty("hazelcast.shutdown.graceful.wait.seconds", "30");
config.setProperty("hazelcast.shutdownhook.enabled", "false");
config.setProperty("hazelcast.icmp.enabled", "true");

验证标准 #

配置完成后关闭节点时，会输出以下关键日志代表优雅下线执行成功：

[HazelcastInstance名称] 正在执行关闭
节点 [IP]:端口 [成员ID] 状态变更为SHUTTING_DOWN
节点 [IP]:端口 已退出集群
集群剩余节点会在2秒内感知到节点主动退出，无需等待心跳超时。

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