Eureka客户端服务未在注册中心显示，请求排查解决

以下是针对你遇到问题的具体排查点和解决办法：

1. Spring Cloud版本不兼容（核心问题） #

你的客户端使用Spring Cloud版本2021.0.1，但注册中心用的是2023.0.1，两个版本属于不同分支，对应Spring Boot版本要求完全不匹配：

• 2021.0.x分支对应Spring Boot 2.6.x~2.7.x
• 2023.0.x分支对应Spring Boot 3.0.x~3.1.x

版本不匹配会导致客户端与注册中心的通信协议、依赖类不兼容，直接引发注册失败。

解决办法：统一两者的Spring Cloud版本，比如都改为2021.0.1（适配Spring Boot 2.7.x，支持Java17），或全部升级到2023.0.1（适配Spring Boot3.x）。

2. 注册中心配置语法错误 #

注册中心application.properties中：

eureka.instance.hostname= localhost

=号后多了空格，会导致主机名被解析为含空格的无效字符串，客户端无法正确连接。

解决办法：删除空格，修改为：

eureka.instance.hostname=localhost

3. 客户端Eureka地址路径不规范 #

客户端配置的注册地址：

eureka.client.serviceUrl.defaultZone=http://localhost:8080/eureka

Eureka服务器默认注册端点是/eureka/（末尾带斜杠），部分版本会严格校验路径，不带斜杠会导致无法识别。

解决办法：修改为带斜杠的地址：

eureka.client.serviceUrl.defaultZone=http://localhost:8080/eureka/

4. 确认注册中心启动类注解 #

注册中心必须在启动类上添加@EnableEurekaServer注解，否则不会启动Eureka服务端功能，客户端自然无法注册。

解决办法：在注册中心启动类添加注解：

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

5. 客户端pom.xml缺失Spring Boot Parent依赖 #

从你提供的客户端pom看，未配置Spring Boot Parent节点，会导致依赖版本管理混乱，可能出现Eureka客户端与Spring Boot版本不兼容的情况。

解决办法：在客户端pom最上方添加Parent节点（对应Spring Cloud2021.0.1，Spring Boot版本用2.7.12）：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.12</version>
    <relativePath/> <!-- 从仓库查找父依赖 -->
</parent>

6. 基础网络与端口检查 #

• 确认注册中心确实在8080端口启动，未被其他程序占用
• 尝试用127.0.0.1替代localhost，避免本地DNS解析问题
• 检查防火墙是否阻止了8080端口的通信

按以上步骤逐一排查，即可解决注册失败问题。

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