Spring Cloud 2024.0.0服务无法注册至Eureka求助

在Spring Cloud 2024.0.0环境中，我的服务无法注册到Eureka，尝试了各类文档及论坛中的配置方案仍未解决，现附上相关信息请求排查。

错误日志 #

2024-12-13T10:20:24.374+10:30  WARN 17348 --- [API-GATEWAY] [foReplicator-%d] com.netflix.discovery.DiscoveryClient    : DiscoveryClient_API-GATEWAY/host.docker.internal:API-GATEWAY:8085 - registration failed Cannot execute request on any known server

com.netflix.discovery.shared.transport.TransportException: Cannot execute request on any known server
    at com.netflix.discovery.shared.transport.decorator.RetryableEurekaHttpClient.execute(RetryableEurekaHttpClient.java:112) ~[eureka-client-2.0.4.jar:2.0.4]
    at com.netflix.discovery.shared.transport.decorator.EurekaHttpClientDecorator.register(EurekaHttpClientDecorator.java:56) ~[eureka-client-2.0.4.jar:2.0.4]
    at com.netflix.discovery.shared.transport.decorator.EurekaHttpClientDecorator$1.execute(EurekaHttpClientDecorator.java:59) ~[eureka-client-2.0.4.jar:2.0.4]
    at com.netflix.discovery.shared.transport.decorator.SessionedEurekaHttpClient.execute(SessionedEurekaHttpClient.java:76) ~[eureka-client-2.0.4.jar:2.0.4]
    at com.netflix.discovery.shared.transport.decorator.EurekaHttpClientDecorator.register(EurekaHttpClientDecorator.java:56) ~[eureka-client-2.0.4.jar:2.0.4]

Eureka Server相关信息 #

启动代码 #

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

@EnableEurekaServer
@SpringBootApplication
public class EurekaApplication {

    public static void main(String[] args) {
        SpringApplication.run(EurekaApplication.class, args);
    }

}

配置文件（application.yml） #

server:
  port: 8761
spring:
  application:
    name: eureka
eureka:
  client:
    register-with-eureka: false
    fetch-registry: false
logging:
  level:
    com.netflix.eureka: OFF
    com.netflix.discovery: OFF

Gateway服务相关信息 #

启动代码 #

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient
public class GatewayApplication {

    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }

}

尝试的配置文件1 #

server:
  port: 8085
spring:
  application:
    name: API-GATEWAY
  cloud:
    gateway:
      routes:
        - id: FACADE-SERVICE
          uri: http://localhost:9300/facade/
          predicates:
            - Path=/FACADE/**
eureka:
  client:
    register-with-eureka: true
    fetch-registry: true
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/
  instance:
    hostname: localhost

尝试的配置文件2 #

server:
  port: 8085
spring:
  application:
    name: API-GATEWAY
  cloud:
    gateway:
      routes:
        - id: FACADE-SERVICE
          uri: http://localhost:9300/facade/
          predicates:
            - Path=/FACADE/**
eureka:
  client:
    register-with-eureka: true
    fetch-registry: true
    service-url:
      default-zone: http://localhost:8761/eureka/
  instance:
    hostname: localhost

依赖配置（pom.xml） #

<properties>
    <java.version>17</java.version>
    <spring-cloud.version>2024.0.0</spring-cloud.version>
</properties>
<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway-mvc</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>${spring-cloud.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

排查建议 #

• 验证Eureka Server可用性：直接访问http://localhost:8761，确认Eureka控制台正常加载。如果无法访问，检查Eureka Server启动日志，排查端口占用、启动失败原因。
• 测试网络连通性：在Gateway服务所在环境，用curl http://localhost:8761/eureka/验证是否能获取Eureka的XML响应。若失败，排查防火墙规则、端口是否对外开放。
• 统一配置键格式：Spring Cloud官方推荐使用kebab-case格式配置，即service-url和default-zone，优先使用第二种尝试的配置格式，避免驼峰与短横线格式的兼容性问题。
• 检查版本兼容性：Spring Cloud 2024.0.0对应Spring Boot 3.2.x版本，确认pom中Spring Boot版本是否匹配，版本不兼容会导致注册逻辑异常。
• 开启详细日志：在Gateway配置中调高Eureka日志级别，查看注册请求的具体细节：

  logging:
    level:
      com.netflix.eureka: DEBUG
      com.netflix.discovery: DEBUG
  

• 排查网络环境：错误日志中出现host.docker.internal，说明Gateway可能运行在Docker容器内。此时localhost指向容器内部，需将default-zone地址改为宿主机IP，或使用Docker host网络模式启动Gateway。
• 确认Eureka Server无访问限制：当前Eureka Server未配置安全认证，可排除权限问题；若后续添加认证，需在Gateway配置中添加对应账号密码。

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