✅ 一、核心概念速记

概念 说明
Eureka Client 微服务本身（Provider/Consumer）注册到 Eureka Server 的客户端组件
服务注册 启动时向 Eureka Server 上报元数据（IP、端口、服务名等）
心跳续约 每30秒发送一次心跳，90秒无心跳则剔除（可配置）
服务发现 从 Eureka Server 拉取服务列表，本地缓存，默认30秒刷新一次
自我保护模式 防止网络抖动误删服务，默认开启（生产可关闭）

✅ 二、Eureka Client注册操作步骤（详细）

👉 步骤1：创建Spring Boot项目（JDK17+）

使用 Spring Initializr 创建项目，勾选：

  • Spring Web
  • Eureka Discovery Client

依赖如下：

<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

👉 步骤2：启用Eureka Client

在主类添加注解：

@SpringBootApplication
@EnableDiscoveryClient // 新版推荐使用，兼容Eureka/Consul/Zookeeper
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

⚠️ 旧版 @EnableEurekaClient 已逐步弃用。

👉 步骤3：配置 application.yml

server:
  port: 8081

spring:
  application:
    name: order-service # 服务名，必须唯一

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/ # Eureka Server地址
  instance:
    prefer-ip-address: true # 注册IP而非主机名
    lease-renewal-interval-in-seconds: 10 # 心跳间隔（默认30）
    lease-expiration-duration-in-seconds: 25 # 失效时间（默认90）

👉 步骤4：启动并验证注册

  1. 启动Eureka Server（端口8761）
  2. 启动当前Client服务
  3. 打开浏览器访问：http://localhost:8761
    看到 order-service 状态为 UP 即注册成功。

✅ 三、常见错误与排查清单

问题描述 排查建议
服务未出现在注册列表 检查 defaultZone 是否正确、Eureka Server是否启动、端口是否开放
状态为 DOWN 或 OUT_OF_SERVICE 检查 /actuator/health 是否返回 UP，或关闭自我保护模式
多实例注册冲突 检查 eureka.instance.instance-id 是否唯一，建议包含随机值或IP+端口
注册延迟 调低 registry-fetch-interval-seconds（默认30s）

✅ 四、注意事项

  • 服务名必须规范：避免使用下划线，推荐 kebab-case，如 user-service
  • 端口冲突：本地启动多实例时，使用 -Dserver.port=8082 动态指定
  • 元数据自定义：
eureka:
  instance:
    metadata-map:
      version: 1.0.0
      zone: us-east-1

✅ 五、使用技巧与最佳实践

技巧类别 实践建议
高可用部署 多个Client注册到Eureka集群，配置多个 defaultZone 地址
健康检查 集成Spring Boot Actuator，暴露 /actuator/health 供Eureka检测
快速下线 服务优雅关闭时主动发送 shutdown 事件，避免Eureka保留失效实例
本地调试 使用 spring.profiles.active=local 区分本地与线上配置

✅ 六、性能优化建议

配置项 建议值 说明
lease-renewal-interval-in-seconds 10~15s 降低心跳间隔，快速感知故障
lease-expiration-duration-in-seconds 30~45s 网络不稳定环境可适当延长
eureka.client.registry-fetch-interval-seconds 15s 降低缓存刷新间隔，提升实时性
eureka.server.enable-self-preservation false（测试） 避免测试环境因心跳丢失误判

✅ 七、一句话总结

Eureka Client注册 = 配置正确 + 心跳保活 + 服务名唯一 + 健康检查通过。