// 拆分之前——同一个 JVM，直接调方法
User user = userService.getUserById(userId);

// 拆分之后——跨 JVM、跨机器
// 你必须写一堆 HTTP 调用代码
RestTemplate restTemplate = new RestTemplate();
String url = "http://user-service:8081/api/users/" + userId;
User user = restTemplate.getForObject(url, User.class);

<dependencies>
    <!-- OpenFeign 核心 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>

    <!-- 负载均衡——Feign 默认集成了 Spring Cloud LoadBalancer -->
    <!-- 不需要额外引入——spring-cloud-starter-openfeign 自带 -->
</dependencies>

@SpringBootApplication
@EnableFeignClients  // ← 一句话开启——Spring 会自动扫描 @FeignClient 接口
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

// 这就是 Feign 的"接口即契约"
// 注意：这个接口放在订单服务中——由调用方定义
// 被调方（用户服务）不需要实现它——完全不侵入
@FeignClient(name = "user-service",      // ① 服务名——对应 Nacos/Eureka 中的服务
             url = "http://localhost:8081")  // ② 开发环境直连——生产用 Nacos 后删掉 url
public interface UserClient {

    // ③ 方法声明和 Spring MVC 注解完全一样
    @GetMapping("/api/users/{userId}")
    User getUser(@PathVariable("userId") Long userId);

    @PostMapping("/api/users")
    User createUser(@RequestBody User user);

    @PutMapping("/api/users/{userId}")
    User updateUser(@PathVariable("userId") Long userId,
                    @RequestBody User user);

    @DeleteMapping("/api/users/{userId}")
    void deleteUser(@PathVariable("userId") Long userId);

    // ④ 复杂查询——多个参数
    @GetMapping("/api/users")
    List<User> listUsers(@RequestParam("keyword") String keyword,
                         @RequestParam("page") int page,
                         @RequestParam("size") int size);

    // ⑤ 返回 ResponseEntity——保留 HTTP 状态码和响应头
    @GetMapping("/api/users/{userId}")
    ResponseEntity<User> getUserWithStatus(@PathVariable("userId") Long userId);
}

@Service
public class OrderService {

    // 注入 Feign 接口——和注入普通 Service 完全一样
    @Autowired
    private UserClient userClient;

    public Order createOrder(CreateOrderRequest request) {
        // ① 调用户服务查用户——和本地方法调用完全一样
        User user = userClient.getUser(request.getUserId());

        if (user == null) {
            throw new BusinessException("用户不存在");
        }

        // ② 创建订单——和以前一样
        Order order = Order.builder()
                .userId(user.getUserId())
                .userName(user.getUserName())  // 冗余用户名
                .items(request.getItems())
                .build();

        return orderRepository.save(order);
    }
}

// 用户服务的 Controller——和以前完全一样
// 不需要实现 Feign 接口、不需要改任何东西
// Feign 只是 HTTP 客户端——调的就是这个普通的 REST Controller
@RestController
@RequestMapping("/api/users")
public class UserController {

    @GetMapping("/{userId}")
    public User getUser(@PathVariable Long userId) {
        return userService.getUser(userId);
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.createUser(user);
    }
}

@FeignClient(name = "user-service")
public interface UserClient {

    // ❌ 错误——@PathVariable 没有指定 value
    @GetMapping("/api/users/{userId}")
    User getUser(@PathVariable Long userId);
    // Feign 报错：PathVariable annotation was empty on param 0
    // 原因：Java 编译时不保留参数名——Feign 不知道这是 "userId"

    // ✅ 正确——显式指定 value
    @GetMapping("/api/users/{userId}")
    User getUser(@PathVariable("userId") Long userId);

    // ❌ 错误——GET 请求用了 @RequestBody
    @GetMapping("/api/users/search")
    List<User> search(@RequestBody UserSearchRequest request);
    // 虽然 HTTP 规范没说 GET 不能有 Body——但很多框架不支持

    // ✅ 正确——用 @SpringQueryMap 把对象转成 Query 参数
    @GetMapping("/api/users/search")
    List<User> search(@SpringQueryMap UserSearchRequest request);
    // UserSearchRequest 的字段会变成 ?keyword=xxx&page=1&size=20
}

<!-- 加上 Nacos 依赖 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

spring:
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

// url 去掉——Feign 自动从 Nacos 查到 user-service 的实例
@FeignClient(name = "user-service")  // ← name 就是 Nacos 中的服务名
public interface UserClient {

    @GetMapping("/api/users/{userId}")
    User getUser(@PathVariable("userId") Long userId);
}

@Autowired
private UserClient userClient;  // 这是个接口——实现类在哪？谁生成的？

// 调用时
User user = userClient.getUser(1L);
// getClass().getName() = com.sun.proxy.$Proxy123  ← JDK 动态代理
// 这是 Feign 在启动时用 JDK 动态代理生成的实现类
// 它拦截所有方法调用 → 根据注解构造 HTTP 请求 → 发出去 → 解析响应