SpringCloud入门教程合集(1)-SpringCloud简介与Eureka+Feign实现服务注册中心、服务提供与服务消费
场景
SpringCloud 总体架构与核心子项目
SpringCloud 总体架构
1. 基础设施层
服务注册与发现：Eureka/Nacos
配置中心：Spring Cloud Config/Nacos
消息总线：Spring Cloud Bus
2. 服务通信层
负载均衡：Ribbon/LoadBalancer
服务调用：Feign/OpenFeign
API网关：Gateway/Zuul
3. 服务治理层
熔断降级：Hystrix/Sentinel
服务监控：Turbine/Hystrix Dashboard
分布式追踪：Sleuth/Zipkin
4. 数据层
分布式缓存：Spring Cache + Redis
分布式事务：Seata
数据库中间件：ShardingSphere
5. 安全控制层
认证授权：Spring Security OAuth2
服务鉴权：JWT
安全网关：Spring Cloud Gateway Security
SpringCloud Netflix 家族项目
SpringCloud Netflix 是 SpringCloud 早期版本的核心组件集合，为微服务架构提供了一系列成熟的解决方案。
尽管部分组件已进入维护模式，但理解其设计理念对掌握微服务架构仍有重要意义。
主要组件
Eureka - 服务注册与发现
Ribbon - 客户端负载均衡
Hystrix - 熔断降级
Zuul - API网关
Feign - 声明式REST客户端
SpringCloud Alibaba 家族项目
SpringCloud Alibaba 是阿里巴巴开源的一套微服务解决方案，为 SpringCloud 生态提供了丰富的企业级组件支持。
主要组件
Nacos - 服务注册与配置中心
Sentinel - 流量控制与熔断降级
Seata - 分布式事务解决方案
RocketMQ - 消息中间件集成
消息轨迹：完整追踪消息生命周期
事务消息：支持分布式事务场景
延迟消息：支持定时消息投递
顺序消息：保证局部顺序消费
Dubbo - RPC通信框架
高性能：基于Netty的NIO通信
多协议：支持Dubbo/REST/gRPC等
负载均衡：随机/轮询/最少活跃调用等策略
服务治理：条件路由/黑白名单/权重调节
Eureka 服务注册与发现框架介绍
1. 两大组件
Eureka Server：注册中心服务器，提供服务注册和发现功能
Eureka Client：服务提供者和消费者，会注册到 Eureka Server
2. 重要术语
服务注册(Register)：服务启动时向 Eureka 注册自己的信息
服务续约(Renew)：客户端定期发送心跳维持注册
服务下线(Cancel)：客户端关闭时主动通知 Eureka
服务剔除(Eviction)：Eureka 清理长时间无心跳的服务
服务获取(Fetch Registry)：客户端从服务器获取服务注册表
3. 服务注册流程
服务提供者启动后向 Eureka Server 注册
Eureka Server 将注册信息存储到注册表
服务消费者从 Eureka Server 获取服务列表
消费者通过负载均衡调用服务提供者
2. 自我保护机制
当超过85%的客户端没有心跳时，Eureka 进入自我保护模式
在此模式下不会剔除任何服务实例
通过 eureka.server.enable-self-preservation 配置
Feign与OpenFeign
Feign
Feign 是 Netflix 开发的声明式 HTTP 客户端。
主要特点
通过注解方式定义和实现 HTTP API 调用
整合了 Ribbon 实现客户端负载均衡
支持可插拔的编码器和解码器
OpenFeign
OpenFeign 是 Spring Cloud 对 Feign 的增强和整合
主要特点
作为 Feign 的升级版本被纳入 Spring Cloud 生态
深度整合 Spring MVC 注解
支持 Spring Cloud 的服务发现（如 Eureka）
提供更完善的 Spring Boot 支持
OpenFeign 核心功能
声明式服务调用
负载均衡
自动集成 Ribbon
支持多种负载均衡策略（轮询、随机等）
服务熔断
可与 Hystrix 或 Sentinel 集成实现熔断降级
请求/响应处理
支持自定义编码器/解码器
支持请求拦截器和响应处理器
常用注解
@FeignClient 声明Feign客户端，主要参数：name/value(服务名), url(直接指定URL)
@RequestMapping 与Spring MVC用法一致
@GetMapping 映射GET请求
@PostMapping 映射POST请求
@RequestParam 请求参数
@PathVariable URL路径变量
@RequestBody 请求体
核心特性对比
最佳实践
最佳实践
接口设计原则
保持Feign接口与服务提供方API一致
使用继承或组合避免重复定义
为复杂对象定义DTO而非直接使用领域模型
性能优化建议
启用HTTP连接池（OKHttp或HttpClient）
合理设置超时时间
对频繁调用的接口考虑缓存结果
异常处理
实现ErrorDecoder处理特定状态码
统一异常转换机制
安全考虑
使用拦截器添加认证信息
敏感信息不应出现在URL或日志中
目录
场景
SpringCloud 总体架构与核心子项目
SpringCloud 总体架构
SpringCloud Netflix 家族项目
SpringCloud Alibaba 家族项目
Eureka 服务注册与发现框架介绍
Feign与OpenFeign
Feign
OpenFeign
核心特性对比
编辑
最佳实践
实现
学前准备（小白必看）
项目创建步骤详解
创建父工程（管理所有模块）
Eureka服务注册中心
服务提供者开发
服务消费者开发
全流程测试
注：
博客：
霸道流氓气质-CSDN博客
实现
学前准备（小白必看）
1. 你需要先掌握的基础
Java基础（类、接口、注解的概念）
SpringBoot简单项目搭建（会写@RestController）
HTTP协议基本了解（GET/POST请求）
项目创建步骤详解
创建父工程（管理所有模块）
IDEA-File → New → Project
选择 Maven → 勾选 Create from archetype → 选择 maven-archetype-site-simple
填写GroupId：ArtifactId：完成创建
修改pom
<packaging>pom</packaging> <!-- 注意这里是pom类型 --><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.7.18</version></parent><properties><java.version>1.8</java.version><spring-cloud.version>2021.0.8</spring-cloud.version><maven.compiler.source>8</maven.compiler.source><maven.compiler.target>8</maven.compiler.target></properties><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服务注册中心
在父工程上右键 → New → Module
选择Maven → 不选archetype
ArtifactId填写：eureka-server
修改pom.xml 添加依赖
<dependencies><!-- Eureka服务端依赖 --><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-netflix-eureka-server</artifactId></dependency><!-- 健康检查（可选） --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency></dependencies>配置文件application.yml
server:port: 8761 # Eureka默认端口eureka:instance:hostname: localhost # 主机名client:register-with-eureka: false # 不注册自己fetch-registry: false # 不获取注册表service-url:defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/ spring:application:name: eureka-server # 应用名称启动类编写
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;@SpringBootApplication
@EnableEurekaServer // 关键注解：启用Eureka服务端功能
public class EurekaServerApplication {public static void main(String[] args) {SpringApplication.run(EurekaServerApplication.class, args);}
}启动并访问
运行启动类后，浏览器访问：http://localhost:8761
你会看到Eureka的管理界面（此时还没有服务注册）
服务提供者开发
创建service-provider模块
添加依赖
<dependencies><!-- Eureka客户端依赖 --><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-netflix-eureka-client</artifactId></dependency><!-- Web支持 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies>配置文件application.yml
server:port: 8081 # 服务端口spring:application:name: service-provider # 重要！这是服务名称eureka:client:service-url:defaultZone: http://localhost:8761/eureka/ # 注册到Eurekainstance:instance-id: ${spring.application.name}:${server.port} # 实例IDprefer-ip-address: true # 显示IP地址编写业务接口
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/provider")
public class ProviderController {// 简单测试接口@GetMapping("/hello")public String hello() {return "Hello, I'm Provider Service!";}// 模拟获取用户信息@GetMapping("/user/{id}")public String getUser(@PathVariable Integer id) {return "User Info - ID: " + id + ", Name: User" + id;}
}启动类
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;@SpringBootApplication
@EnableDiscoveryClient // 启用服务发现客户端
public class ServiceProviderApplication {public static void main(String[] args) {SpringApplication.run(ServiceProviderApplication.class, args);}
}验证注册
先启动Eureka Server
再启动Service Provider
刷新Eureka页面(http://localhost:8761)，应该能看到SERVICE-PROVIDER服务
服务消费者开发
创建service-consumer模块
添加依赖
<dependencies><!-- Eureka客户端 --><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-netflix-eureka-client</artifactId></dependency><!-- OpenFeign --><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId></dependency><!-- Web支持 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies>配置文件application.yml
server:port: 8082spring:application:name: service-consumereureka:client:service-url:defaultZone: http://localhost:8761/eureka/# Feign配置（可选）
feign:client:config:default: # 全局配置connectTimeout: 5000 # 连接超时5秒readTimeout: 5000 # 读取超时5秒创建Feign客户端接口
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;@FeignClient(name = "service-provider") // 指定服务名称
public interface ProviderClient {// 对应provider的/hello接口@GetMapping("/provider/hello")String callHello();// 对应provider的/user/{id}接口@GetMapping("/provider/user/{id}")String getUser(@PathVariable Integer id);
}编写消费者Controller
import com.badao.feign.ProviderClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/consumer")
public class ConsumerController {@Autowiredprivate ProviderClient providerClient; // 注入Feign客户端@GetMapping("/test")public String testFeign() {return "Feign调用结果：" + providerClient.callHello();}@GetMapping("/user/{id}")public String getUser(@PathVariable Integer id) {return "通过Feign获取：" + providerClient.getUser(id);}
}启动类（关键注解）
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients // 关键！启用Feign客户端扫描
public class ServiceConsumerApplication {public static void main(String[] args) {SpringApplication.run(ServiceConsumerApplication.class, args);}
}全流程测试
启动顺序很重要！
启动 eureka-server（端口8761）
启动 service-provider（端口8081）
启动 service-consumer（端口8082）
验证服务注册
访问 http://localhost:8761
测试接口调用
直接调用Provider：
http://localhost:8081/provider/hello
返回：Hello, I'm Provider Service!
通过Feign调用：
http://localhost:8082/consumer/test
返回：Feign调用结果：Hello, I'm Provider Service!
带参数的调用：
http://localhost:8082/consumer/user/123
