From 44457c9971958854582c3567126a21dae5520571 Mon Sep 17 00:00:00 2001
From: bunny <1319900154@qq.com>
Date: Mon, 26 May 2025 18:37:15 +0800
Subject: [PATCH] =?UTF-8?q?:sparkles:=20=E8=BF=9C=E7=A8=8B=E8=B0=83?=
 =?UTF-8?q?=E7=94=A8-=E8=B6=85=E6=97=B6=E6=8E=A7=E5=88=B6-=E5=A4=B1?=
 =?UTF-8?q?=E8=B4=A5=E9=87=8D=E8=AF=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 cloud-demo/ReadMe.md                          | 177 ++++++++++++++++++
 .../service/config/OrderServiceConfig.java    |   8 +
 2 files changed, 185 insertions(+)

diff --git a/cloud-demo/ReadMe.md b/cloud-demo/ReadMe.md
index d4afa34..29ff59a 100644
--- a/cloud-demo/ReadMe.md
+++ b/cloud-demo/ReadMe.md
@@ -335,3 +335,180 @@ spring:
     activate:
       on-profile: test
 ```
+
+## OpenFeign
+
+### 基础配置
+
+#### 依赖引入
+
+```xml
+<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-openfeign</artifactId>
+    <version>${spring-cloud.version}</version>
+</dependency>
+```
+
+#### 启用Feign客户端
+
+```java
+@SpringBootApplication
+@EnableDiscoveryClient
+@EnableFeignClients(basePackages = "com.yourpackage.feign")
+public class OrderServiceApplication {
+    public static void main(String[] args) {
+        SpringApplication.run(OrderServiceApplication.class, args);
+    }
+}
+```
+
+### Feign客户端使用
+
+#### 服务间调用
+
+**Feign客户端定义**：
+
+```java
+@FeignClient(
+    value = "service-product", 
+    path = "/api/product",
+    configuration = ProductFeignConfig.class
+)
+public interface ProductFeignClient {
+
+    @GetMapping("/{id}")
+    ResponseEntity<Product> getProductById(@PathVariable("id") Long productId);
+
+    @PostMapping
+    ResponseEntity<Void> createProduct(@RequestBody Product product);
+}
+```
+
+**服务调用示例**：
+
+```java
+@Service
+@RequiredArgsConstructor
+public class OrderService {
+
+    private final ProductFeignClient productFeignClient;
+
+    public Order createOrder(Long productId, Long userId) {
+        // 使用Feign客户端调用远程服务
+        ResponseEntity<Product> response = productFeignClient.getProductById(productId);
+        
+        if (!response.getStatusCode().is2xxSuccessful()) {
+            throw new RuntimeException("商品服务调用失败");
+        }
+
+        Product product = response.getBody();
+        Order order = new Order();
+        // 订单业务逻辑处理...
+        return order;
+    }
+}
+```
+
+#### 第三方服务调用
+
+```java
+@FeignClient(
+    name = "bunny-client", 
+    url = "${external.bunny.api.url}", 
+    configuration = ExternalFeignConfig.class
+)
+public interface BunnyFeignClient {
+
+    @PostMapping("/login")
+    ResponseEntity<String> login(@RequestBody LoginDto loginDto);
+}
+```
+
+**测试用例**：
+
+```java
+@SpringBootTest
+public class BunnyFeignClientTest {
+
+    @Autowired
+    private BunnyFeignClient bunnyFeignClient;
+
+    @Test
+    void testLogin() {
+        LoginDto loginDto = new LoginDto("bunny", "admin123", "default");
+        ResponseEntity<String> response = bunnyFeignClient.login(loginDto);
+        
+        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK);
+        System.out.println("登录响应: " + response.getBody());
+    }
+}
+```
+
+### 负载均衡对比
+
+#### 客户端负载均衡 vs 服务端负载均衡
+
+| 特性         | 客户端负载均衡 (OpenFeign) | 服务端负载均衡 (Nginx等) |
+| ------------ | -------------------------- | ------------------------ |
+| **实现位置** | 客户端实现                 | 服务端实现               |
+| **依赖关系** | 需要服务注册中心           | 不依赖注册中心           |
+| **性能**     | 直接调用，减少网络跳转     | 需要经过代理服务器       |
+| **灵活性**   | 可定制负载均衡策略         | 配置相对固定             |
+| **服务发现** | 集成服务发现机制           | 需要手动维护服务列表     |
+| **适用场景** | 微服务内部调用             | 对外暴露API或跨系统调用  |
+
+### 高级配置
+
+#### 日志配置
+
+**application.yml**:
+
+```yaml
+logging:
+  level:
+    org.springframework.cloud.openfeign: DEBUG
+    com.yourpackage.feign: DEBUG
+```
+
+**Java配置**：
+
+```java
+public class FeignConfig {
+    
+    @Bean
+    Logger.Level feignLoggerLevel() {
+        return Logger.Level.FULL;  // NONE, BASIC, HEADERS, FULL
+    }
+}
+```
+
+#### 超时与重试配置
+
+**application-feign.yml**:
+
+```yaml
+spring:
+  cloud:
+    openfeign:
+      client:
+        config:
+          default:  # 全局默认配置
+            connect-timeout: 2000
+            read-timeout: 5000
+            logger-level: basic
+            
+          service-product:  # 特定服务配置
+            connect-timeout: 3000
+            read-timeout: 10000
+```
+
+**重试机制配置**：
+
+```java
+@Bean
+public Retryer feignRetryer() {
+    // 重试间隔100ms，最大间隔1s，最大尝试次数3次
+    return new Retryer.Default(100, 1000, 3);
+}
+```
diff --git a/cloud-demo/services/service-order/src/main/java/cn/bunny/service/config/OrderServiceConfig.java b/cloud-demo/services/service-order/src/main/java/cn/bunny/service/config/OrderServiceConfig.java
index 9485da6..2d05382 100644
--- a/cloud-demo/services/service-order/src/main/java/cn/bunny/service/config/OrderServiceConfig.java
+++ b/cloud-demo/services/service-order/src/main/java/cn/bunny/service/config/OrderServiceConfig.java
@@ -1,6 +1,7 @@
 package cn.bunny.service.config;
 
 import feign.Logger;
+import feign.Retryer;
 import org.springframework.cloud.client.loadbalancer.LoadBalanced;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
@@ -9,6 +10,13 @@ import org.springframework.web.client.RestTemplate;
 @Configuration
 public class OrderServiceConfig {
 
+    @Bean
+    public Retryer feignRetryer() {
+        // 重试间隔100ms，最大间隔1s，最大尝试次数3次
+        // return new Retryer.Default();
+        return new Retryer.Default(100, 1000, 3);
+    }
+
     @Bean
     @LoadBalanced
     public RestTemplate restTemplate() {