OpenFeign 服务调用

这一课你将能做到

1. 在 user-service 里声明一个 Feign 接口，像调本地方法一样调用 problem-service 的 HTTP API
2. 配置全局与单个 Client 的超时，并通过 RequestInterceptor 把登录态透传给下游
3. 说清 Feign 背后的动态代理流程，以及它和注册中心、负载均衡的配合

为什么要学

服务拆开之后必然互相调用：user-service 的「学习面板」要展示用户信息 + 在学题目，就得调 problem-service。用 RestTemplate/RestClient 手写：URL 自己拼、负载均衡自己做、超时要手动包、接口变了编译期毫无提示——全是样板代码。

OpenFeign 是声明式 HTTP 客户端：定义一个 Java 接口加注解，框架在运行时生成实现，帮你完成「按服务名找实例 → 负载均衡选一个 → 发 HTTP → 反序列化成对象」整套动作。代码里只剩接口和 DTO，可读性和可测试性都上一个台阶。

先建立图像

user-service 里调用：
   problemClient.getProblem(1L)          ← 看起来是本地方法
        │
        ▼
   Feign 动态代理（运行时生成的接口实现）
        │  ① 解析 @GetMapping("/problems/{id}") 拼出请求模板
        │  ② LoadBalancer 按服务名 problem-service 问 Eureka 要实例列表，轮询选一个
        │  ③ RequestInterceptor 补 Header（如 Authorization）
        │  ④ 发出 HTTP GET http://10.0.0.7:8082/problems/1
        ▼
   problem-service 返回 JSON → 反序列化成 ProblemDTO 返回给调用方

关键词：声明式接口 + 动态代理 + 服务名寻址 + 负载均衡。

跟着做

步骤 1：给 user-service 加依赖

pom.xml：

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-loadbalancer</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

步骤 2：定义 DTO 与 Feign 接口

DTO（两端共享或各自定义一份，字段名对齐即可）：

package com.example.user.dto;

public record ProblemDTO(Long id, String title, String difficulty) {}

Feign 接口：

package com.example.user.client;

import com.example.user.dto.ProblemDTO;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RequestBody;

import java.util.List;

@FeignClient(name = "problem-service")   // name = 注册中心里的服务名
public interface ProblemClient {

    @GetMapping("/problems/{id}")
    ProblemDTO getProblem(@PathVariable("id") Long id);

    @GetMapping("/problems")
    List<ProblemDTO> listByDifficulty(@RequestParam("difficulty") String difficulty);

    @PostMapping("/problems/{id}/favorite")
    void favorite(@PathVariable("id") Long id, @RequestBody FavoriteRequest req);

    record FavoriteRequest(Long userId, boolean favorite) {}
}