Solon Solon Rpc 使用注册与发现服务
2026年9月14日 上午5:13:07
更多内容可参考：《Solon Cloud 开发（分布式套件）/使用分布式发现与注册服务》
1、 从固定 URL 改成服务名
固定 URL 适合第一次调用；服务实例变多、地址经常变化后，客户端应使用：
name + path → LoadBalance/Discovery → 某个实例的 URL + path
固定地址：
@NamiClient(url = "http://localhost:9001/rpc/v1/user", headers = ContentTypes.JSON)
UserService userService;
（改变）服务名方式：
@NamiClient(name = "userapi", path = "/rpc/v1/user", headers = ContentTypes.JSON)
UserService userService;
url 与 name/path 是两种寻址方式。不要同时把它们当作两个独立地址配置；实际选哪一个应按你的发现方案约定。
2、使用本地发现服务（适合学习）
- 服务端
不需要改造，也不需要注册。
- 客户端，改造
引入 solon-cloud 插件依赖（自带了本地发现能力）。修改应用配置：
solon.cloud.local:
discovery:
service:
userapi: #添加本地服务发现（userapi 为服务名）
- "http://localhost:8081"
服务使用的地方改造一下：
@Mapping("user")
public class UserController {
//直接指定地址和序列化方案（旧的不要了）
//@NamiClient(url = "http://localhost:9001/rpc/v1/user", headers = "Content-Type=application/json")
//指定服务名、路径和序列化方案（新的不用关注服务地址）
@NamiClient(name = "userapi", path="/rpc/v1/user", headers=ContentTypes.JSON)
UserService userService;
@Post
@Mapping("register")
public Result register(User user){
//调用远程服务，添加用户
userService.add(user);
return Result.succeed();
}
}
3、使用分布式（中间件）注册与发现服务
以某个 Cloud Discovery 插件为例，服务端负责注册自身，客户端负责查询实例。两端通常需要：
- 引入相同注册中心插件。
- 配置相同的注册中心地址。
- 确认 group、name、namespace 等标识一致。
- 确认服务端暴露地址是客户端可访问的地址。
- 确认健康检查和实例状态正常。
注册中心配置不是 Nami 本身的固定 API；Nacos、Water、Consul、ZooKeeper 等插件的坐标和配置不同，不应混写。
下面使用 water-solon-cloud-plugin 做为注册与发现服务。其它的 solon cloud 注册与服务插件都可。
- 服务端项目，改造
引入 water-solon-cloud-plugin 插件依赖（或者别的注册与发现服务）。修改应用配置：
server.port: 9001
solon.app:
group: "demo"
name: "userapi"
solon.cloud.water:
server: "waterapi:9371"
其它不用动。
- 客户端项目，改造
引入 water-solon-cloud-plugin 插件依赖。修改应用配置：
server.port: 8081
solon.app:
group: "demo"
name: "userdemo"
solon.cloud.water:
server: "waterapi:9371"
服务使用的地方改造一下：
@Mapping("user")
public class UserController {
//直接指定地址和序列化方案（旧的不要了）
//@NamiClient(url = "http://localhost:9001/rpc/v1/user", headers = "Content-Type=application/json")
//指定服务名、路径和序列化方案（新的不用关注服务地址）
@NamiClient(name = "userapi", path="/rpc/v1/user", headers=ContentTypes.JSON)
UserService userService;
@Post
@Mapping("register")
public Result register(User user){
//调用远程服务，添加用户
userService.add(user);
return Result.succeed();
}
}
打包后，启动服务。(要在water环境下运行)
java -jar userdemo.jar
4、排错方法（先本地再分布式）
出现问题时，可以按这个顺序排错。
固定 URL 能否调用？
↓ 能
本地 name 映射能否调用？
↓ 能
再接入分布式注册中心
↓
最后检查多实例和负载策略
如果固定 URL 成功、服务名失败，业务接口通常没有问题，重点检查发现插件、服务名、分组和实例地址。