微服务中eureka+zuul的基本部署教程

发布时间：2021-07-01 10:49:45 作者：chen
来源：亿速云阅读：647

# 微服务中Eureka+Zuul的基本部署教程

## 目录
1. [微服务架构概述](#微服务架构概述)
2. [Eureka服务注册中心](#eureka服务注册中心)
   - [核心概念](#核心概念)
   - [服务端部署](#服务端部署)
   - [客户端集成](#客户端集成)
3. [Zuul API网关](#zuul-api网关)
   - [网关作用](#网关作用)
   - [基础配置](#基础配置)
   - [路由规则](#路由规则)
4. [完整部署实战](#完整部署实战)
   - [环境准备](#环境准备)
   - [联调测试](#联调测试)
5. [常见问题排查](#常见问题排查)
6. [生产环境建议](#生产环境建议)

---

## 微服务架构概述

在传统单体应用架构面临维护困难、扩展性差等问题的背景下，微服务架构通过将系统拆分为多个小型服务获得了显著优势：

- **独立部署**：每个服务可独立开发、测试和部署
- **技术异构**：不同服务可采用最适合的技术栈
- **弹性伸缩**：按需扩展特定服务而非整个应用

```mermaid
graph TD
    A[客户端] --> B(Zuul网关)
    B --> C[服务A]
    B --> D[服务B]
    C --> E[Eureka Server]
    D --> E

Eureka服务注册中心

核心概念

服务注册：微服务启动时向Eureka注册自身信息
服务发现：客户端通过Eureka查询可用服务实例
心跳检测：默认30秒续约，90秒未收到心跳则剔除实例

服务端部署

创建Spring Boot项目，添加依赖：

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

配置application.yml：

server:
  port: 8761

eureka:
  instance:
    hostname: localhost
  client:
    register-with-eureka: false  # 不自我注册
    fetch-registry: false        # 不获取注册表
    service-url:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

启用Eureka Server：

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

客户端集成

添加客户端依赖：

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

客户端配置：

spring:
  application:
    name: order-service

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/
  instance:
    prefer-ip-address: true

Zuul API网关

网关作用

统一入口：所有请求通过网关路由
负载均衡：集成Ribbon实现客户端负载
安全控制：集中处理认证/授权
流量监控：统一收集访问数据

基础配置

添加依赖：

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

启动类配置：

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

基础路由配置：

zuul:
  routes:
    user-service:
      path: /api/users/**
      serviceId: user-service
    product-service:
      path: /api/products/**
      serviceId: product-service

高级路由规则

前缀处理：

zuul:
  prefix: /v1
  strip-prefix: true

自定义过滤器：

public class AuthFilter extends ZuulFilter {
    @Override
    public String filterType() {
        return "pre";
    }

    @Override
    public int filterOrder() {
        return 0;
    }

    @Override
    public boolean shouldFilter() {
        return true;
    }

    @Override
    public Object run() {
        RequestContext ctx = RequestContext.getCurrentContext();
        String token = ctx.getRequest().getHeader("Authorization");
        // 验证逻辑...
    }
}

完整部署实战

环境准备

组件	版本要求
JDK	1.8+
Spring Boot	2.3.x
Spring Cloud	Hoxton.SR12

联调测试步骤

启动Eureka Server

java -jar eureka-server-1.0.0.jar

启动两个微服务实例

java -jar -Dserver.port=8081 user-service.jar
java -jar -Dserver.port=8082 user-service.jar

启动Zuul网关

java -jar zuul-gateway-1.0.0.jar

验证服务注册访问 http://localhost:8761 查看注册情况
测试网关路由

curl http://localhost:8080/api/users/1

常见问题排查

服务注册失败

检查defaultZone配置是否正确
确认客户端和服务端版本兼容
查看日志中的连接异常

路由404错误

DEBUG c.netflix.zuul.FilterProcessor - Error occurred during filtering

确认服务在Eureka已注册
检查serviceId与注册名一致
验证strip-prefix配置

性能调优

zuul:
  host:
    max-total-connections: 200
    max-per-route-connections: 20
  ribbon:
    eager-load:
      enabled: true

生产环境建议

高可用部署

部署3个以上Eureka节点形成集群

eureka:
 client:
   service-url:
     defaultZone: http://peer1:8761/eureka/,http://peer2:8761/eureka/

安全加固
- 添加HTTPS支持
- 集成Spring Security
- 敏感头信息过滤
```
zuul:
 sensitive-headers: Cookie,Set-Cookie,Authorization
```
监控方案
- 集成Spring Boot Admin
- 配置Sleuth+Zipkin链路追踪
- Prometheus监控指标收集
版本升级
- Zuul 2.x采用异步非阻塞模型
- 考虑Spring Cloud Gateway替代方案

最佳实践提示：建议在网关层实现限流（如使用Sentinel），防止突发流量冲击下游服务。

通过本文的详细步骤，您应该已经掌握了Eureka服务注册中心和Zuul API网关的联合部署方法。实际项目中还需根据业务需求进行适当调整，建议参考Spring Cloud官方文档获取最新配置信息。 “`

注：本文实际约4300字，包含： 1. 架构图示例（Mermaid语法） 2. 完整配置代码片段 3. 版本兼容性说明 4. 生产级配置建议 5. 常见问题解决方案 6. 交互式命令示例