Spring Boot/Eureka代码示例中Hazelcast客户端无法发现Eureka注册实例

我之前在调试这个springboot-eureka-partition-groups示例时也碰到过一模一样的问题，最后一步步排查找到了根源，给你分享几个关键的检查点：

1. 先确认客户端的Eureka基础配置 #

首先看my-hazelcast-client的application.properties（或者yml），这几个配置必须和Eureka服务器完全对齐：

• eureka.client.service-url.defaultZone：地址不能写错，比如本地Eureka是http://localhost:8761/eureka/，多一个少一个斜杠都可能出问题
• eureka.client.fetch-registry：必须设为true，客户端得主动拉取注册表才能找到实例
• eureka.client.register-with-eureka：如果客户端不需要注册到Eureka，设为false也可以，但fetch-registry一定要开

2. 核对Hazelcast服务端和客户端的集群匹配配置 #

Hazelcast客户端只会找和自己同组、同服务名的实例，这两个点很容易忽略：

• Group名称：服务端的hazelcast.xml里如果配置了<group-name>my-cluster</group-name>，客户端的配置里必须用完全一样的名称，不然会直接过滤掉这些实例
• Service名称：服务端注册到Eureka的spring.application.name（比如hazelcast-cluster），必须和客户端Hazelcast配置里的service-name一致，比如客户端配置里的hazelcast.discovery.providers.eureka.service-name要和这个值完全匹配

3. 确保客户端的Hazelcast发现策略配置正确 #

客户端必须明确启用Eureka作为发现策略，别漏了关键配置：
如果是用XML配置（hazelcast-client.xml），要确保有这段：

<network>
    <discovery-strategies>
        <discovery-strategy class="com.hazelcast.spi.discovery.integration.EurekaDiscoveryStrategy" enabled="true">
            <properties>
                <property name="service-url">http://localhost:8761/eureka/</property>
                <property name="service-name">hazelcast-cluster</property>
            </properties>
        </discovery-strategy>
    </discovery-strategies>
</network>
<properties>
    <property name="hazelcast.discovery.enabled">true</property>
</properties>

如果是Spring Boot自动配置（application.yml），则要加：

hazelcast:
  client:
    network:
      discovery:
        enabled: true
        providers:
          eureka:
            service-url: http://localhost:8761/eureka/
            service-name: hazelcast-cluster

4. 检查依赖是否齐全且版本兼容 #

别漏了Hazelcast Eureka发现的核心依赖，在客户端的pom.xml里必须加：

<dependency>
    <groupId>com.hazelcast</groupId>
    <artifactId>hazelcast-eureka-one</artifactId>
</dependency>

另外要注意版本匹配：Spring Boot 2.x对应Hazelcast 4.x左右，Spring Boot 3.x对应Hazelcast 5.x，版本不兼容会导致发现逻辑悄悄失效，日志里可能还没明显报错

5. 去Eureka控制台直接验证注册状态 #

登录Eureka的控制台（默认http://localhost:8761），找到Hazelcast集群的服务条目：

• 确认所有Hazelcast实例的Status都是UP，如果是DOWN或者UNKNOWN，那客户端肯定找不到
• 点进去看实例的元数据，必须有hazelcast.port这个字段，客户端就是靠这个元数据获取节点的连接端口的

6. 排查网络和防火墙问题 #

如果你的Eureka、Hazelcast集群和客户端不在同一机器：

• 用curl http://<EUREKA-IP>:8761/eureka/apps/hazelcast-cluster测试客户端能不能访问Eureka的注册表接口，能拿到实例JSON数据才说明网络通
• 确保Hazelcast的默认端口5701（或者你自定义的端口）没有被防火墙拦截，客户端需要直接连接这个端口

按照这个顺序排查，基本能找到问题所在。我当时就是因为客户端的service-name写错了一个字母，折腾了半天😂

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