Dubbo 之 “最速传说”

1. 什么是 Dubbo

Dubbo 是一款 RPC 框架，用来解决微服务之间调用的问题。

举个例子：项目里有订单服务、用户服务，分别部署在不同机器上。订单服务想获取某个用户的信息，怎么办？

写 HTTP 请求？拼接 URL？解析返回的 JSON？

太麻烦了。用了 Dubbo，可以像调用本地方法一样调用远程服务：

java 复制代码

userService.getUserById(1L);  // 这行代码实际上是远程调用

2. 工作流程

复制代码

订单服务                    用户服务
    │                          │
    │─── Dubbo ──────────────>  │
    │    RPC 调用              │
    │                          │
    │<────────── 返回结果 ──────│

订单服务不需要知道用户服务在哪台机器、端口是多少，Dubbo 自动处理。

3. Spring Boot 集成

3.1 引入依赖

xml 复制代码

<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-spring-boot-starter</artifactId>
    <version>3.3.0</version>
</dependency>

<dependency>
    <groupId>com.alibaba.nacos</groupId>
    <artifactId>nacos-client</artifactId>
</dependency>

3.2 配置

yaml 复制代码

dubbo:
  registry:
    address: nacos://localhost:8848
  protocol:
    name: dubbo
    port: 20880

4. 提供者

定义一个接口，双方共享：

java 复制代码

public interface UserService {
    User getUserById(Long id);
}

实现类打上 @DubboService 注解：

java 复制代码

@DubboService
public class UserServiceImpl implements UserService {
    
    @Override
    public User getUserById(Long id) {
        return userMapper.selectById(id);
    }
}

这样就把服务暴露出去了，消费者可以发现并调用。

5. 消费者

用 @DubboReference 注入：

java 复制代码

@Service
public class OrderService {

    @DubboReference
    private UserService userService;

    public void createOrder(Long userId) {
        // 像调用本地方法一样，实际是远程调用
        User user = userService.getUserById(userId);
        
        // 创建订单...
    }
}

6. 常用配置

超时时间

默认 3 秒，超过就报错。可以按需调整：

java 复制代码

@DubboReference(timeout = 5000)
private UserService userService;

负载均衡

多个服务节点时，请求怎么分配：

java 复制代码

// random：随机（默认）
// roundrobin：轮询
// leastactive：优先分配负载低的
@DubboReference(loadbalance = "roundrobin")
private UserService userService;

重试机制

调用失败后自动重试几次：

java 复制代码

@DubboReference(retries = 3)
private UserService userService;

指定版本

灰度发布时常用，新旧版本同时存在：

java 复制代码

// 提供者 v1.0
@DubboService(version = "1.0")
public class UserServiceImplV1 implements UserService {}

// 提供者 v2.0
@DubboService(version = "2.0")
public class UserServiceImplV2 implements UserService {}

// 消费者指定用哪个版本
@DubboReference(version = "2.0")
private UserService userService;

7. 完整示例

java 复制代码

// 1. 接口
public interface OrderService {
    Order createOrder(Long userId, List<Long> itemIds);
}

// 2. 提供者实现
@DubboService(version = "1.0")
public class OrderServiceImpl implements OrderService {
    
    @DubboReference
    private UserService userService;
    
    @DubboReference
    private StockService stockService;
    
    @Override
    public Order createOrder(Long userId, List<Long> itemIds) {
        // 获取用户信息（远程调用）
        User user = userService.getUserById(userId);
        
        // 扣减库存（远程调用）
        stockService.deduct(itemIds);
        
        // 创建订单
        Order order = new Order();
        order.setUserId(userId);
        order.setItems(itemIds);
        return order;
    }
}

// 3. 消费者调用
@RestController
public class OrderController {

    @DubboReference
    private OrderService orderService;

    @PostMapping("/order")
    public Order createOrder(@RequestParam Long userId, 
                            @RequestParam List<Long> itemIds) {
        return orderService.createOrder(userId, itemIds);
    }
}

8. 总结

@DubboService 暴露服务
@DubboReference 注入远程服务
支持超时、重试、负载均衡、版本控制
用 Nacos 或 Zookeeper 做注册中心

Dubbo 上手很简单，核心就是两个注解搞定远程调用。