一、Eureka 基础概念
1. 什么是 Eureka?
- 定位:Spring Cloud 生态中的 服务注册与发现组件,用于实现微服务架构中的服务治理。
- 核心功能:
- 服务注册:微服务启动时向 Eureka 注册自身信息(如 IP、端口、服务名等)。
- 服务发现:其他服务通过 Eureka 获取注册的服务列表及实例信息,实现远程调用。
- 服务心跳:服务定期向 Eureka 发送心跳(默认 30 秒),维持注册状态。
- 服务剔除:若服务超过一定时间(默认 90 秒)未发送心跳,Eureka 会将其从注册表中剔除。
2. 角色划分
- Eureka Server:服务注册中心,负责维护服务注册表,处理服务注册、发现、心跳等请求。
- Eureka Client:微服务实例,既可以是服务提供者(注册自身),也可以是服务消费者(从注册中心获取服务列表)。
二、Eureka 架构原理
1. 架构图
plaintext
+-----------------+ +-----------------+
| Eureka Server | | Eureka Server |
| (节点1) | | (节点2) |
+-------+---------+ +-------+---------+
| |
| 互相复制注册表数据 |
| |
+-----------------+---------+ +-----------------+---------+
| Eureka Client | | | Eureka Client | |
| (服务A) | | | (服务B) | |
| 注册/心跳 | | | 注册/心跳 | |
+-----------------+----+----+ +-----------------+----+----+
| |
| 拉取服务列表、发起调用 |
+----------------------------------+
2. 核心机制
- 服务注册:
- 客户端启动时,通过 HTTP 请求向 Eureka Server 发送自身元数据(如
eureka.instance.hostname
、eureka.instance.port
)。 - Server 接收后将信息存入注册表,并返回
204 No Content
。
- 客户端启动时,通过 HTTP 请求向 Eureka Server 发送自身元数据(如
- 服务续约(心跳):
- 客户端默认每 30 秒向 Server 发送心跳(
/eureka/apps/{appName}/{instanceId}/status
)。 - Server 若在 90 秒内未收到心跳,标记实例为 DOWN,并在后续剔除。
- 客户端默认每 30 秒向 Server 发送心跳(
- 服务发现:
- 客户端通过
GET /eureka/apps
接口获取全量服务列表,或通过GET /eureka/apps/{appName}
获取指定服务列表。 - 支持 增量更新(
/eureka/delta
),减少网络传输开销。
- 客户端通过
- 服务剔除:
- Server 启动定时任务(默认每 60 秒),扫描过期实例并剔除。
- 客户端正常关闭时会发送
DELETE
请求主动注销,避免脏数据。
- 自我保护模式:
- 当 Server 检测到超过 85% 的客户端心跳失败时,自动进入自我保护模式,不剔除任何实例。
- 目的:避免因网络波动导致健康服务被误删,保障系统可用性。
- 退出条件:心跳恢复正常比例后,自动退出。
三、Eureka 配置与使用
1. 搭建 Eureka Server
步骤:
- 添加依赖(Maven):
xml
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>
- 启用 Eureka Server:
在启动类上加@EnableEurekaServer
注解:
java
@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {
public static void main(String[] args) {
SpringApplication.run(EurekaServerApplication.class, args);
}
}
- 配置文件(
application.properties
):
properties
# 服务端口
server.port=8761
# 关闭自我保护模式(开发环境建议关闭,生产环境默认开启)
eureka.server.enable-self-preservation=false
# 清理过期实例的间隔时间(秒)
eureka.server.eviction-interval-timer-in-ms=60000
# 不注册自己为客户端(Server 本身不消费服务)
eureka.client.register-with-eureka=false
eureka.client.fetch-registry=false
# 注册中心地址(集群时配置其他节点地址)
eureka.client.service-url.defaultZone=http://localhost:8761/eureka/
2. 注册微服务到 Eureka
步骤:
- 添加依赖:
xml
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
- 配置文件:
properties
# 服务名称(用于注册中心显示)
spring.application.name=service-provider
# 注册到 Eureka Server 的地址
eureka.client.service-url.defaultZone=http://localhost:8761/eureka/
# 实例主机名(默认取 localhost,可指定 IP)
eureka.instance.hostname=192.168.1.100
# 显示实例 IP 而非主机名
eureka.instance.prefer-ip-address=true
# 心跳间隔(秒,默认 30 秒)
eureka.instance.lease-renewal-interval-in-seconds=10
# 过期时间(秒,默认 90 秒)
eureka.instance.lease-expiration-duration-in-seconds=30
3. 服务发现与调用
- 客户端获取服务列表:
通过DiscoveryClient
接口获取注册的服务实例:java
@Autowired private DiscoveryClient discoveryClient; public void getServiceInstances() { List<ServiceInstance> instances = discoveryClient.getInstances("service-provider"); instances.forEach(instance -> { String url = instance.getUri().toString(); // 服务地址(http://IP:port) // 发起远程调用(如 RestTemplate) }); }
- 结合 Ribbon 实现负载均衡:
在 RestTemplate 上添加@LoadBalanced
注解,通过服务名直接调用:java
@Bean @LoadBalanced public RestTemplate restTemplate() { return new RestTemplate(); } // 调用示例 restTemplate.getForObject("http://service-provider/api/data", String.class);
四、Eureka 集群配置
1. 原理
- 多个 Eureka Server 节点互相注册,形成集群,注册表数据双向复制,保证高可用。
- 每个节点既是 Server,也是其他节点的 Client(需开启
register-with-eureka
和fetch-registry
)。
2. 配置示例(双节点集群)
节点 1(8761 端口)配置:
properties
eureka.client.service-url.defaultZone=http://localhost:8762/eureka/
eureka.client.register-with-eureka=true # 注册到其他节点
eureka.client.fetch-registry=true # 从其他节点拉取注册表
节点 2(8762 端口)配置:
properties
server.port=8762
eureka.client.service-url.defaultZone=http://localhost:8761/eureka/
eureka.client.register-with-eureka=true
eureka.client.fetch-registry=true
五、Eureka 与其他组件对比
特性 | Eureka(Netflix) | Consul(HashiCorp) | Nacos(Alibaba) |
---|---|---|---|
服务发现 | 支持 | 支持 | 支持 |
配置中心 | 不支持 | 支持 | 支持 |
数据模型 | 基于 REST | 基于 HTTP/DNS | 基于 REST |
健康检查 | 客户端主动心跳 | 支持客户端 / 服务端检查 | 支持多种检查方式 |
多数据中心 | 支持(需手动配置) | 原生支持 | 支持 |
社区生态 | Spring Cloud 集成良好 | 生态成熟 | 国产生态,适配 Spring Cloud |
当前状态 | Netflix 已停更维护 | 活跃 | 活跃 |
六、Eureka 的优缺点与适用场景
1. 优点
- 简单易用:基于 REST 接口,集成和配置简单。
- 高可用性:通过集群模式实现服务注册中心的高可用。
- 客户端逻辑轻量:服务发现逻辑封装在客户端,无需额外组件。
2. 缺点
- 维护停止:Netflix 已停止维护 Eureka,社区更新缓慢。
- 自我保护模式双刃剑:可能导致脏数据,需谨慎配置。
- 无配置中心:需配合 Spring Cloud Config 等组件实现配置管理。
3. 适用场景
- 传统微服务架构(非云原生场景)。
- 对服务注册发现需求简单,且无需复杂配置管理的项目。
- 遗留系统迁移或短期项目(长期建议转向 Nacos/Consul)。
七、Eureka 常用配置项
配置项 | 说明 | 默认值 |
---|---|---|
eureka.client.service-url.defaultZone | Eureka Server 地址(可配置多个,用逗号分隔) | http://localhost:8761/eureka/ |
eureka.instance.lease-renewal-interval-in-seconds | 心跳间隔(秒) | 30 |
eureka.instance.lease-expiration-duration-in-seconds | 过期时间(秒) | 90 |
eureka.server.enable-self-preservation | 是否开启自我保护模式 | true |
eureka.server.eviction-interval-timer-in-ms | 剔除过期实例的间隔时间(毫秒) | 60000 |
eureka.client.fetch-registry | 是否从注册中心拉取服务列表 | true |
eureka.client.register-with-eureka | 是否将自身注册到注册中心 | true |
八、最佳实践
- 生产环境建议:
- 开启 自我保护模式(默认开启),避免网络波动导致服务不可用。
- 部署至少 2 个 Eureka Server 节点,形成集群。
- 客户端配置合理的心跳间隔和过期时间(如心跳 10 秒,过期 30 秒)。
- 开发环境建议:
- 关闭自我保护模式(
eureka.server.enable-self-preservation=false
),便于快速测试服务剔除。 - 使用短心跳和过期时间(如心跳 5 秒,过期 10 秒),加快开发调试效率。
- 关闭自我保护模式(
- 监控与告警:
- 集成 Spring Boot Actuator,监控 Eureka 指标(如注册表实例数、心跳失败率)。
- 对服务实例状态变化(UP→DOWN)设置告警,及时排查故障。