Hazelcast 5.3.6客户端如何配置dns_lookup替代kubernetes_api发现模式

出现这种情况通常是因为Hazelcast的自动配置逻辑（尤其是Kubernetes相关的）优先级高于自定义的ClientConfig，或者存在残留的配置/依赖触发了kubernetes_api模式。以下是具体解决步骤：

1. 禁用Kubernetes自动配置（Spring Boot环境） #

如果项目基于Spring Boot，Hazelcast的Kubernetes自动配置类会自动启用kubernetes_api发现模式，即使自定义了ClientConfig。需要显式排除它：

• 在application.properties中添加：

  spring.autoconfigure.exclude=com.hazelcast.spring.boot.autoconfigure.HazelcastKubernetesAutoConfiguration
  

• 或者在application.yaml中添加：

  spring:
    autoconfigure:
      exclude: com.hazelcast.spring.boot.autoconfigure.HazelcastKubernetesAutoConfiguration
  

2. 确保自定义ClientConfig完全覆盖发现策略 #

创建ClientConfig Bean时，要清空默认的发现策略，再明确添加dns_lookup配置，避免残留设置干扰：

@Bean
public ClientConfig hazelcastClientConfig() {
    ClientConfig config = new ClientConfig();
    config.setClusterName("你的集群名称");

    // 清空所有默认发现策略
    config.getNetworkConfig().getDiscoveryConfig().clearDiscoveryStrategies();

    // 配置dns_lookup发现策略
    DiscoveryStrategyConfig dnsStrategy = new DiscoveryStrategyConfig(new DnsLookupDiscoveryStrategyFactory());
    // 设置集群的DNS服务名（根据实际DNS记录修改）
    dnsStrategy.addProperty("service-dns", "hazelcast-cluster.default.svc.cluster.local");
    // 可选：指定集群端口，默认5701
    dnsStrategy.addProperty("service-port", "5701");

    config.getNetworkConfig().getDiscoveryConfig().addDiscoveryStrategyConfig(dnsStrategy);
    return config;
}

3. 清理环境变量与配置文件 #

• 检查系统环境变量，确保没有设置HAZELCAST_CLIENT_DISCOVERY_KUBERNETES_ENABLED=true或其他触发Kubernetes发现的变量；
• 查看项目中是否存在hazelcast-client.xml、hazelcast-client.yaml这类配置文件，如果里面有kubernetes_api相关的发现配置，直接删除或注释掉。

4. 移除不必要的依赖 #

如果项目中引入了hazelcast-kubernetes依赖，但实际不需要用Kubernetes API发现模式，直接从依赖管理文件（如pom.xml、build.gradle）中移除该依赖，从根源上避免自动触发kubernetes_api模式。

验证方法 #

启动应用后，查看客户端日志，若出现类似[INFO] com.hazelcast.client.impl.connection.discovery.DiscoveryClientConnectionManager - Using DNS lookup discovery strategy的日志，说明配置生效。

内容的提问来源于stack exchange，提问作者Alejandro Garcia Marchena