本地Eureka Client无法注册至localhost Eureka Server求助

问题描述 #

我是Spring Cloud入门学习者，端口8761的Eureka Server运行正常，但标注@EnableEurekaClient的服务无法完成注册。客户端服务启动无报错，但在Eureka控制台看不到该服务实例。

Eureka Server配置 #

application.properties

server.port=8761
eureka.client.register-with-eureka=false
eureka.client.fetch-registry=false
eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/
eureka.instance.hostname=localhost
eureka.server.enable-self-preservation=true
eureka.server.eviction-interval-timer-in-ms=60000
eureka.server.wait-time-in-ms-when-sync-empty=3000
spring.application.name=eurekaServer

pom.xml

<dependencies>
    <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
            <version>4.0.1</version>
    </dependency>
</dependencies>

Eureka Client配置 #

application.properties

server.port=8799
spring.application.name=product
eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/
eureka.client.registerWithEureka=true
eureka.client.fetchRegistry=true

pom.xml

<properties>
    <maven.compiler.source>19</maven.compiler.source>
    <maven.compiler.target>19</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>3.1.1</version>
    </dependency>
   
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-netflix-eureka-client</artifactId>
        <version>3.1.4</version>
    </dependency>
</dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2022.0.3</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

排查与修复步骤 #

1. 版本兼容性修复（核心问题） #

Eureka Server使用的spring-cloud-starter-netflix-eureka-server:4.0.1对应Spring Cloud 2022.0.x（Kilburn），该版本要求搭配Spring Boot 3.x；而客户端的spring-cloud-netflix-eureka-client:3.1.4对应Spring Cloud 2021.0.x（Jubilee），仅支持Spring Boot 2.6/2.7，和你使用的Spring Boot 3.1.1不兼容，这是注册失败的主要原因。

修复方案：
移除客户端eureka-client依赖的手动版本号，让dependencyManagement中导入的2022.0.3来管理版本（和Server版本匹配）：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-netflix-eureka-client</artifactId>
    <!-- 去掉version，由dependencyManagement自动匹配 -->
</dependency>

2. 配置键名标准化 #

客户端配置中使用了驼峰写法的registerWithEureka和fetchRegistry，建议改为Spring Boot标准的横杠分隔写法，避免解析异常：

# 替换原有配置
eureka.client.register-with-eureka=true
eureka.client.fetch-registry=true

3. 确认启动类注解 #

确保客户端启动类添加了@EnableEurekaClient或@EnableDiscoveryClient注解：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

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

4. 开启日志排查（可选） #

如果以上修复后仍有问题，开启客户端DEBUG日志查看注册请求细节：

logging.level.com.netflix.eureka=DEBUG
logging.level.org.springframework.cloud=DEBUG

启动后检查日志中是否包含向http://localhost:8761/eureka/发送的注册请求，以及是否有隐藏的错误信息。

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