Springboot单体架构下如何做远程调用 (源码)

小Mie不吃饭

于 2025-07-22 09:14:38 发布

阅读量808

点赞数 13

CC 4.0 BY-SA版权

文章标签： springboot fegin 远程调用

本文链接：https://blog.youkuaiyun.com/weixin_56861179/article/details/149526311

Spring Boot 单体架构下要做“远程调用”，其实就是把原来进程内直接 new 的调用，改成跨进程的 HTTP 调用。

✅ 方案 1：最轻量——RestTemplate（无依赖，单体可用）

步骤 1：提供方（order-service，端口 8081）

@RestController@RequestMapping("/user")public class UserController {    @GetMapping("/{id}")    public User getUser(@PathVariable Long id){        return new User(id, "Mike");    }}

步骤 2：调用方（单体应用，端口 8080）

@SpringBootApplicationpublic class App {    public static void main(String[] args) { SpringApplication.run(App.class, args); }    @Bean    public RestTemplate restTemplate() { return new RestTemplate(); }}@Servicepublic class OrderService {    @Autowired    private RestTemplate restTemplate;    public Order queryOrder(Long orderId){        Order order = orderMapper.findById(orderId);        // 远程调用        User user = restTemplate.getForObject(                "http://localhost:8081/user/" + order.getUserId(), User.class);        order.setUser(user);        return order;    }}

只需 Spring-Web 依赖即可，适合“两个独立 Spring Boot 单体”互相调用。

✅ 方案 2：声明式——OpenFeign（需要 Spring Cloud）

如果想像调用本地接口一样写远程调用，可以用 OpenFeign，但需要引入 Spring Cloud（本质上也是 HTTP）。

步骤 1：依赖

<dependency>  <groupId>org.springframework.cloud</groupId>  <artifactId>spring-cloud-starter-openfeign</artifactId></dependency>

步骤 2：启用 Feign

@SpringBootApplication@EnableFeignClients      // 开启 Feignpublic class App { }

步骤 3：声明客户端

@FeignClient(name = "user-service", url = "http://localhost:8081")public interface UserClient {    @GetMapping("/user/{id}")    User getUser(@PathVariable Long id);}

步骤 4：直接注入使用

@Servicepublic class OrderService {    @Autowired    private UserClient userClient;    public Order queryOrder(Long orderId){        Order order = orderMapper.findById(orderId);        order.setUser(userClient.getUser(order.getUserId()));        return order;    }}

这种方式代码最简洁，但引入了 Spring Cloud 依赖，适合后期可能拆微服务的单体。

✅ 方案 3：最新 JDK 17+ 玩法——HTTP Interfaces（Spring Boot 3）

Spring Boot 3 提供了“声明式 HTTP 客户端”新特性，写法与 Feign 类似，但不依赖 Spring Cloud。

步骤 1：声明接口

public interface UserClient {    @GetExchange("/user/{id}")    User getUser(@PathVariable Long id);}

步骤 2：生成代理 Bean

@Configuration

public class HttpClientConfig {

    @Bean

    public UserClient userClient() {

        WebClient webClient = WebClient.builder().baseUrl("http://localhost:8081").build();

        HttpServiceProxyFactory factory = HttpServiceProxyFactory.builder(WebClientAdapter.forClient(webClient)).build();

        return factory.createClient(UserClient.class);

    }

}

步骤 3：注入使用

@Servicepublic class OrderService {    @Autowired    private UserClient userClient;    public Order queryOrder(Long orderId){        Order order = orderMapper.findById(orderId);        order.setUser(userClient.getUser(order.getUserId()));        return order;    }}

需要 Spring Boot 3 + Java 17，依赖最轻，语法最优雅。

场景	推荐方案
两个独立 Spring Boot 单体，最快速	方案 1 RestTemplate
单体未来可能拆微服务，需要熔断、负载均衡	方案 2 OpenFeign
项目已升级到 Spring Boot 3 & Java 17，追求简洁	方案 3 HTTP Interfaces