Hazelcast 3.x.x迁移至5.x.x Java客户端：代码替代方案咨询

核心变化说明 #

Hazelcast 5.x 彻底移除了 GroupConfig 相关API，原有的组名（group name）对应替换为集群名称（cluster name），密码认证逻辑则通过UsernamePasswordCredentials结合客户端安全配置模块实现。

替代代码示例 #

程序化配置实现 #

// 创建客户端配置实例
ClientConfig clientConfig = new ClientConfig();

// 设置集群名称（对应原GroupConfig.setName()）
clientConfig.setClusterName(HZ_USER);

// 配置用户名密码认证（对应原GroupConfig.setPassword()）
clientConfig.getSecurityConfig()
    .setCredentials(new UsernamePasswordCredentials(HZ_USER, HZ_PASSWORD));

// 初始化Hazelcast客户端
HazelcastInstance hz = HazelcastClient.newHazelcastClient(clientConfig);

配置文件方式（可选） #

如果习惯通过hazelcast-client.xml配置，对应配置项如下：

<hazelcast-client>
    <cluster-name>${HZ_USER}</cluster-name>
    <security>
        <credentials class-name="com.hazelcast.security.UsernamePasswordCredentials">
            <properties>
                <property name="username">${HZ_USER}</property>
                <property name="password">${HZ_PASSWORD}</property>
            </properties>
        </credentials>
    </security>
</hazelcast-client>

关键注意事项 #

• 服务端需同步更新配置：启用security模块，配置UsernamePasswordLoginModule等对应认证器，并设置与客户端一致的集群名称。
• 若使用其他认证方式（如Token），可替换Credentials的实现类，但原3.x的组密码认证逻辑对应上述UsernamePasswordCredentials方案。

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