Dubbo 是一款高性能、轻量级的开源 Java RPC 框架，它可以帮助开发人员快速构建分布式服务。在 Dubbo 应用中，我们经常需要提供 HTTP 调用，如供 H5、外部系统等调用。一般的做法是为需要提供 HTTP 调用的服务编写 Controller，但这并非必需，可以通过网关来适配。

目录

01 介绍

02 Dubbo 快速开始

启动管理后台

启动网关

启动客户端服务

03 测试

04 总结

---

01 介绍

本文要介绍的是开源微服务网关 Apache ShenYu（神禹），其架构图如下：

github地址：https://github.com/apache/shenyu

这是一款使用 Java Reactor 开发的异步的，高性能的，跨语言的，响应式 API 网关。通过插件的方式支持 Dubbo 等主流微服务框架，Apache ShenYu 于 2022 年 7 月毕业成为 Apache 顶级项目。

ShenYu 网关由两部分组成，管理后台 shenyu-admin 和网关 shenyu-bootstrap。管理后台能够可视化管理所有插件、选择器和规则，设置用户、角色，控制资源，将配置数据同步给网关。可通过源码运行，也可下载二进制包部署，或者使用 Docker 等容器方式部署。

将应用接入 ShenYu 网关是通过注册中心实现的，ShenYu 网关支持多种注册中心，如 Zookeeper、Consul 和 Nacos 等，也可以通过 HTTP 的方式直接向网关注册。HTTP 请求经过 nginx（可选）发送到 ShenYu 网关，网关根据规则选择 Dubbo 插件，由 Dubbo 插件调用目标服务。

02 Dubbo 快速开始

启动管理后台

默认使用 h2 数据库，可以根据需要修改 conf/application.yml 中的 spring.profiles.active，以使用其它支持的数据库。查看 conf 目录的配置文件可以知道，目前还支持 MySQL、GaussDB、Oracle 和 PostgreSQL 数据库。源码方式启动，直接运行 shenyu-admin 中的 ShenyuAdminBootstrap ，或者二进制包方式启动，执行 bin/start.sh 脚本。

进入管理界面，默认端口为 9095，默认用户名/密码为 admin/123456。登录后左上角可以切换中英文语言。首先从菜单 基础配置->插件管理 中开启 Dubbo 插件（左上角输入 dubbo 能快速找到该插件），并设置注册中心地址，请确保注册中心可用。

启动网关

默认使用 websocket 的方式与管理后台进行数据同步，可根据需要改为 http 长轮询或者是使用注册中心进行数据同步。配置项虽多，但大部分是用于示例，被注释或者是关闭状态。源码方式启动，直接运行 shenyu-bootstrap 中的 ShenyuBootstrapApplication，或者二进制包方式启动，执行 bin/start.sh 脚本。

启动客户端服务

可以用源码包中的例子 shenyu-examples-dubbo（注意区分 dubbo 的版本是 apache dubbo 还是 alibaba dubbo），修改配置文件中的 dubbo 注册地址和网关注册参数 shenyu.register.*。服务启动成功之后会自动把使用了 @ShenyuDubboClient 注解的接口方法注册到网关。

03 测试

回到管理后台，菜单中打开 插件列表 -> rpc proxy -> dubbo 可以看到，使用 @ShenyuDubboClient 注解的接口方法都出现在选择器规则列表中。注意到 Dubbo Proxy 的状态为关闭，点击右边的开关进行开启。

使用源码目录中的 apache-dubbo-test-api.http 文件可以发起 HTTP 请求进行测试。这个文件是 IDEA 自带的接口测试工具 HTTP Client 产生的脚本文件，点击编辑区左边勾槽的绿色三角形可以发起 HTTP 请求进行测试。

测试结果如下，收到的返回报文由 shenyu-examples-dubbo 中的服务返回：

04 总结

通过使用 ShenYu 网关，我们可以发起 HTTP 请求来调用 Dubbo 服务，而无需额外编写 Controller 代码。在外部环境与 Dubbo 服务之间增加 ShenYu 网关，使得 Dubbo 服务成为网关的客户端服务。这种架构的优点在于，当需要更新客户端服务时，只需直接重启该服务即可（请注意，客户端服务需要多节点部署，以确保在重启期间有其他相同的服务能够满足业务需求）。ShenYu 网关的客户端注册插件会在宿主服务优雅停机时通知 ShenYu 网关该服务已下线，从而简化了运维操作，并在更新服务时实现用户无感知。

ShenYu 网关还有很多强大而实用的功能，关注我，一起学习一起成长吧！