Hazelcast集群无法启动，多端口启动时节点无法加入集群

问题根源分析 #

从你的日志和代码来看，两个核心问题的本质是实例间的集群发现机制没有正确配置：

• 每个实例使用独立端口（5701、5702）是正常行为：Hazelcast默认会从5701开始自动选取可用端口，端口不同本身不影响集群，但如果实例无法发现彼此，就会各自形成单节点集群。
• 集群无法组建、节点无法加入：默认的多播发现机制可能在你的环境中被禁用（比如防火墙限制、Docker/云环境不支持多播），导致实例无法互相感知。

解决方案：显式配置集群发现机制 #

你需要修改Hazelcast配置，替换默认的多播发现为更可靠的TCP-IP发现（适合大多数生产/开发环境），同时确保所有实例使用相同的集群名称。

修改后的Spring Boot配置代码

@SpringBootApplication
@Configuration
public class HazelcastApplication {
    public static void main(String[] args) {
        SpringApplication.run(HazelcastApplication.class, args);
    }

    @Bean
    public Config hazelcastConfig() {
        Config config = new Config();
        // 设置统一的集群名称，确保所有实例属于同一个集群
        config.setClusterName("my-hazelcast-cluster");
        
        // 配置TCP-IP发现机制
        NetworkConfig networkConfig = config.getNetworkConfig();
        JoinConfig joinConfig = networkConfig.getJoin();
        
        // 禁用默认的多播发现
        joinConfig.getMulticastConfig().setEnabled(false);
        
        // 启用TCP-IP发现，指定允许加入集群的节点地址（可以是IP或主机名，支持端口范围）
        TcpIpConfig tcpIpConfig = joinConfig.getTcpIpConfig();
        tcpIpConfig.setEnabled(true);
        // 本地启动多实例时，添加本地IP或localhost即可
        tcpIpConfig.addMember("127.0.0.1:5701").addMember("127.0.0.1:5702");
        // 开发环境也可以直接允许所有本地节点：tcpIpConfig.setAllowedInterfaces("127.0.0.1");

        return config;
    }

    @Bean(destroyMethod = "shutdown")
    public HazelcastInstance createStorageNode() throws Exception {
        // 使用自定义配置创建实例
        return Hazelcast.newHazelcastInstance(hazelcastConfig());
    }
}

启动多实例的注意事项

1. 指定端口启动：本地启动多个实例时，建议通过JVM参数显式指定端口，避免自动端口的不确定性：

   # 第一个实例（默认5701）
   java -jar your-app.jar
   # 第二个实例，指定端口5702
   java -jar your-app.jar --hazelcast.port=5702
   

2. 检查网络权限：确保实例之间的端口（默认5701-5708）可以互相访问，本地测试时可暂时关闭防火墙或开放对应端口。

验证集群状态

启动成功后，日志会显示类似以下内容，说明节点已成功加入同一集群：

Members [2] {
Member [127.0.0.1]:5701 this
Member [127.0.0.1]:5702
}

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