Dubbo 转 HTTP 调用方式详解

Dubbo 本身是基于 TCP 私有协议（如 dubbo://） 的高性能 RPC 框架，默认不直接支持标准的 HTTP/1.1 RESTful 接口，但通过以下 三种主流方案 可以实现 Dubbo 服务通过 HTTP 方式调用，满足跨语言、前端交互或网关代理的需求。

一、方案 1：使用 Dubbo 原生 `rest://` 协议（官方扩展，推荐）

1. 核心原理

Dubbo 2.7+ 提供了实验性的 rest 协议，基于 JAX-RS（如 Jersey、RESTEasy） 或 Spring MVC 实现，允许将 Dubbo 服务方法直接映射为 HTTP/REST 接口（类似 Spring Cloud 的 Controller 风格）。

2. 适用场景

需要将 Dubbo 服务直接暴露为 HTTP 接口（供前端、移动端或其他语言调用）。
希望保持 Dubbo 的高性能，同时兼容 RESTful 设计规范（如 JSON 传输、路径路由）。

3. 实现步骤

（1）添加依赖（以 Jersey 为例）

在 pom.xml 中引入 Dubbo 和 JAX-RS 实现（如 Jersey）的依赖：

<!-- Dubbo 核心依赖（Spring Boot 示例） -->
<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-spring-boot-starter</artifactId>
    <version>2.7.20</version> <!-- 根据实际版本调整 -->
</dependency>

<!-- JAX-RS 实现（Jersey） -->
<dependency>
    <groupId>org.glassfish.jersey.containers</groupId>
    <artifactId>jersey-container-servlet</artifactId>
    <version>2.35</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jersey.inject</groupId>
    <artifactId>jersey-hk2</artifactId>
    <version>2.35</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-json-jackson</artifactId>
    <version>2.35</version>
</dependency>

（2）定义 Dubbo 服务接口与实现（集成 JAX-RS 注解）

通过 JAX-RS 注解（如 @Path、@GET） 定义 HTTP 路由，同时用 Dubbo 的 @Service 注解 暴露服务：

import javax.ws.rs.*;
import javax.ws.rs.core.MediaType;
import org.apache.dubbo.config.annotation.DubboService;

// Dubbo 服务注解（暴露服务）
@DubboService // 相当于 @Service(interfaceClass = UserRestService.class)
// JAX-RS 接口定义（HTTP 映射）
@Path("/users") // 根路径
public class UserRestServiceImpl implements UserRestService {

    @GET
    @Path("/{id}") // 子路径（如 /users/1）
    @Produces(MediaType.APPLICATION_JSON) // 返回 JSON
    public User getUser(@PathParam("id") Long id) {
        return new User(id, "User-" + id);
    }

    @POST
    @Path("/create")
    @Consumes(MediaType.APPLICATION_JSON) // 接收 JSON 请求体
    public String createUser(User user) {
        return "Created: " + user.getName();
    }
}

// 服务接口（需单独定义）
public interface UserRestService {
    User getUser(Long id);
    String createUser(User user);
}

// 数据模型（需可序列化为 JSON）
public class User {
    private Long id;
    private String name;
    // 构造方法、getter/setter 省略...
}

（3）配置 Dubbo 协议为 `rest`

在 application.yml（Spring Boot）中指定协议为 rest，并配置端口和上下文路径：

dubbo:
  application:
    name: dubbo-rest-demo
  protocol:
    name: rest      # 使用 rest 协议
    port: 8080      # HTTP 服务端口（客户端通过此端口访问）
    contextpath: /api  # 可选：统一路径前缀（如 /api/users/1）
  registry:
    address: zookeeper://127.0.0.1:2181  # 注册中心（可选）

（4）调用方式

启动服务后，Dubbo 会将 UserRestService 暴露为 HTTP 接口：

GET 请求：http://localhost:8080/api/users/1 → 返回 {"id":1,"name":"User-1"}。
POST 请求：http://localhost:8080/api/users/create（请求体为 JSON {"id":2,"name":"Test"}）→ 返回 "Created: Test"。

注意：rest 协议底层仍是 Dubbo 管理的服务，但通过 HTTP 传输，兼容性更强（浏览器、移动端可直接调用）。

二、方案 2：通过 API 网关代理（生产推荐，解耦架构）

1. 核心原理

不修改 Dubbo 服务代码，保持其使用原生协议（如 dubbo://），通过 API 网关（如 Nginx、Spring Cloud Gateway、Kong） 将 HTTP 请求转发到 Dubbo 服务。网关负责 HTTP 到 Dubbo 协议的转换（如路径映射、参数解析、JSON <-> Java 对象转换）。

2. 适用场景

生产环境需要高并发、低延迟（Dubbo 原生协议性能优于 HTTP）。
已有网关层，希望统一管理 HTTP 接口（如鉴权、限流、日志）。
需要兼容多协议（如同时支持 HTTP 和 gRPC）。

3. 实现步骤

（1）Dubbo 服务配置（原生协议）

在 application.yml 中配置 Dubbo 使用默认的 dubbo 协议（TCP 私有协议）：

dubbo:
  application:
    name: dubbo-native-demo
  protocol:
    name: dubbo  # 原生协议（基于 TCP）
    port: 20880  # Dubbo 服务端口
  registry:
    address: zookeeper://127.0.0.1:2181

定义普通 Dubbo 服务（无需 HTTP 注解）：

import org.apache.dubbo.config.annotation.DubboService;

@DubboService
public class UserServiceImpl implements UserService {
    @Override
    public User getUser(Long id) {
        return new User(id, "User-" + id);
    }
}

（2）配置 API 网关（以 Spring Cloud Gateway 为例）

通过网关将 HTTP 请求（如 http://gateway:8080/api/users/1）路由到 Dubbo 服务的消费端（或直接到 Dubbo Provider 的 HTTP 适配层）。

示例网关配置（application.yml）：

spring:
  cloud:
    gateway:
      routes:
        - id: dubbo-user-service
          uri: lb://dubbo-consumer  # 转发到 Dubbo 消费者服务（需消费者提供 HTTP 接口）
          predicates:
            - Path=/api/users/**
          filters:
            - RewritePath=/api/(?<segment>.*), /$\{segment}  # 路径重写

更复杂的场景：使用 Dubbo 网关中间件（如 dubbo-gateway），网关将 HTTP 请求转换为 Dubbo RPC 调用（通过 Dubbo 客户端调用 @DubboReference 服务）。

三、方案 3：第三方扩展（如 dubbo-http，谨慎选择）

部分社区项目（如 dubbo-http）提供将 Dubbo 服务直接映射为 HTTP 接口的模块，但通常依赖特定版本或定制化开发，稳定性和维护性较弱，仅建议在特定场景下尝试。

实现要点（示例）

添加第三方依赖（如 dubbo-http-adapter）。
通过注解或配置文件将 Dubbo 接口映射为 HTTP 路径（如 @HttpMethod(path = "/users/{id}")）。
启动服务后，通过 HTTP 访问映射后的接口。

注意：此类方案需详细阅读社区文档，可能存在兼容性风险（如 Dubbo 版本升级后失效）。

四、方案对比与选型建议

方案	核心特点	适用场景	性能	跨语言支持	实现复杂度
Dubbo `rest://` 协议	官方扩展，将 Dubbo 服务直接映射为 HTTP/REST 接口（基于 JAX-RS/Spring MVC）	需直接暴露 HTTP 接口（兼容前端/多语言）	中等	高（天然支持）	中等
API 网关代理	保持 Dubbo 原生协议（高性能），通过网关（如 Nginx、Gateway）转换 HTTP 请求	生产环境高并发、低延迟需求	高	依赖网关配置	低（仅需配置网关）
第三方扩展	社区提供的 HTTP 映射模块（如 dubbo-http）	特定场景定制化需求	可变	可变	高（维护风险）