10分钟快速掌握Dubbo核心概念，通过完整可运行的代码案例，带你在本地搭建第一个分布式服务！

一、Dubbo 是什么？

Apache Dubbo 是一款高性能Java RPC框架，提供三大核心能力：

• 服务透明调用：像调用本地方法一样调用远程服务
• 智能负载均衡：内置多种负载均衡策略
• 服务自动注册与发现：基于注册中心动态管理服务节点

二、核心角色图解

[服务提供者] --> 注册服务到 --> [注册中心]
[服务消费者] --> 从注册中心发现服务 --> [调用服务]

三、前置准备

1. JDK 8+
2. Maven 3.6+
3. IDE（IntelliJ IDEA推荐）
4. 注册中心（本文使用Nacos，也可使用Zookeeper）

四、快速开始（含完整代码）

1. 创建Maven父工程

xml

    dubbo-api
    dubbo-provider
    dubbo-consumer



    
        
            org.apache.dubbo
            dubbo-bom
            3.2.0
            pom
            import
        
    

2. 定义服务接口（API模块）

java

// UserService.java
public interface UserService {
    String getUserInfo(Long userId);
}

3. 服务提供者实现

pom.xml添加：

xml

    
        org.apache.dubbo
        dubbo
    
    
        com.alibaba.nacos
        nacos-client
        2.1.0
    

服务实现类：

java

// UserServiceImpl.java
@DubboService
public class UserServiceImpl implements UserService {
    @Override
    public String getUserInfo(Long userId) {
        return "User_" + userId + ": {name: Tony, age: 30}";
    }
}

启动类配置：

java

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

4. 服务消费者调用

application.yml配置：

yaml

dubbo:
  application:
    name: dubbo-consumer
  registry:
    address: nacos://127.0.0.1:8848
  consumer:
    check: false

远程服务调用：

java

@RestController
public class UserController {
    
    @DubboReference
    private UserService userService;

    @GetMapping("/user/{id}")
    public String getUser(@PathVariable Long id) {
        return userService.getUserInfo(id);
    }
}

五、运行测试

1. 启动Nacos服务器（默认端口8848）
2. 启动ProviderApplication
3. 启动ConsumerApplication
4. 访问：http://localhost:8080/user/123

预期输出：

User_123: {name: Tony, age: 30}

六、进阶配置（按需使用）

1. 负载均衡策略

java

@DubboReference(loadbalance = "roundrobin")
private UserService userService;

2. 超时设置

yaml

dubbo:
  consumer:
    timeout: 3000 # 单位毫秒

3. 服务版本控制

java

@DubboService(version = "1.0.0")
@DubboReference(version = "1.0.0")

七、常见问题排查

• 服务未注册成功：检查Nacos控制台服务列表
• 找不到提供者：确认消费者和提供者使用相同的接口全限定名
• 调用超时：检查网络连通性，适当增加超时时间

动手实践后别忘记：

1. 点击让更多开发者看到
2. 转发到技术群帮助小伙伴
3. 收藏备用，随时查阅

完整代码地址： [GitHub链接]（评论区获取）

有任何问题欢迎留言讨论！下期预告：《Dubbo高级特性：流量灰度发布实战》