Java 后端 / 系统课时

实现服务间调用

实现服务间调用

本课学习如何在 Java 微服务中实现服务之间的调用,掌握 OpenFeign 声明式客户端的完整配置方式,并理解一次远程请求从接口代理到目标服务响应的执行链路。

学习目标

  • 理解微服务调用中客户端、服务发现和网络请求之间的关系
  • 掌握 OpenFeign 接口定义与启用配置的基本实现方式
  • 能够验证服务调用结果并定位常见调用失败原因

服务间调用的基本模型

微服务之间通常通过网络接口通信,调用方依赖的是服务契约,而不是目标服务内部代码。一次调用通常包含客户端代理生成、服务定位、请求发送、响应转换等步骤。

在 Spring Cloud 体系中,OpenFeign 将 HTTP 调用封装为接口调用。开发者定义远程接口后,框架会生成代理对象,负责根据注解信息构造请求并处理返回结果。

OpenFeign 服务调用流程

配置 OpenFeign 客户端

使用 OpenFeign 前需要启用 Feign 扫描能力,并创建描述目标服务接口的客户端。接口中的请求路径、参数和返回对象需要与服务端 API 保持一致。

java
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

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

@FeignClient(name = "user-service")
interface UserClient {
    @GetMapping("/users/{id}")
    UserDTO findById(@PathVariable("id") Long id);
}

class UserDTO {
    private Long id;
    private String name;

    public Long getId() {
        return id;
    }

    public String getName() {
        return name;
    }
}

预期输出

text
应用启动成功,Feign Client 已注册,可以通过 UserClient 调用 user-service。

业务服务注入客户端后,可以像调用本地接口一样发起远程请求。

java
import org.springframework.stereotype.Service;

@Service
class OrderService {
    private final UserClient userClient;

    OrderService(UserClient userClient) {
        this.userClient = userClient;
    }

    public String createOrder(Long userId) {
        UserDTO user = userClient.findById(userId);
        return user.getName();
    }
}

预期输出

text
调用成功后返回对应用户名称。

理解一次调用的执行过程

一次 Feign 调用首先由业务代码调用接口代理,代理根据接口元数据生成 HTTP 请求,然后根据服务名称找到目标实例并发送请求,最后将响应内容转换为 Java 对象返回给业务层。

排查问题时需要按照调用链路定位。服务无法找到通常属于服务发现问题,请求超时可能与网络或目标服务负载有关,返回业务错误则需要检查接口处理逻辑。

生产调用中的关键边界

远程调用不能按照本地方法调用的方式设计,需要提前处理超时、重试、异常和数据兼容问题。合理设置调用参数可以避免单个服务故障导致整个调用链阻塞。

OpenFeign 适合业务接口明确、调用关系稳定的服务间通信场景。在高吞吐或低延迟场景下,还需要结合连接池、异步调用或其他通信方案进行进一步优化。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

实现服务间调用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通