答案:通过jsonrpcserver和jsonrpclib-pelix库可快速实现Python的JSON-RPC通信,服务端用@method注册add、subtract、divide方法并启动HTTP服务,客户端调用远程函数并处理返回结果,支持标准JSON-RPC格式请求、错误响应及批量调用,适用于微服务间轻量级通信。

在 Python 中实现 JSON-RPC(JSON Remote Procedure Call)可以通过多种方式完成,最常见的是使用第三方库来快速搭建客户端和服务端。JSON-RPC 是一种轻量级的远程调用协议,使用 JSON 作为数据格式,通常通过 HTTP 或 TCP 传输。
1. 使用 jsonrpcserver 和 jsonrpclib-pelix
一个简单且常用的方法是结合 jsonrpcserver 实现服务端,用 jsonrpclib-pelix 实现客户端。
安装依赖:
pip install jsonrpcserver jsonrpclib-pelix
2. 实现服务端
使用 jsonrpcserver 创建一个支持 JSON-RPC 的 HTTP 服务。
立即学习“Python免费学习笔记(深入)”;
from jsonrpcserver import method, serve, Result, Success, Error@method def add(a: int, b: int) -> Result: return Success(a + b)
@method def subtract(a: int, b: int) -> Result: return Success(a - b)
@method def divide(a: float, b: float) -> Result: if b == 0: return Error(code=20, message="除数不能为零") return Success(a / b)
if name == "main": serve(port=5000)
上述代码启动了一个监听 5000 端口的 HTTP 服务,注册了三个方法:add、subtract、divide。请求需符合 JSON-RPC 格式。
3. 实现客户端
使用 jsonrpclib-pelix 调用远程方法。
from jsonrpclib import Server连接到服务端
server = Server("https://www.php.cn/link/6060d322713797e84f598ea25c812cab")
调用远程方法
print(server.add(5, 3)) # 输出: 8 print(server.subtract(10, 4)) # 输出: 6 print(server.divide(10, 2)) # 输出: 5.0 print(server.divide(10, 0)) # 输出错误信息
客户端发送标准 JSON-RPC 请求,如:
--> {"jsonrpc": "2.0", "method": "add", "params": {"a": 5, "b": 3}, "id": 1}
<-- {"jsonrpc": "2.0", "result": 8, "id": 1}
4. 自定义处理与错误返回
jsonrpcserver 支持返回 Success 或 Error,便于统一响应格式。你也可以添加日志、认证或中间件增强功能。
- 使用
@method(name="myAdd")可自定义方法名 - 服务端可集成到 Flask 或 FastAPI 中以获得更大灵活性
- 支持通知(无 ID 请求)、批量请求等 JSON-RPC 2.0 特性
基本上就这些。Python 中实现 JSON-RPC 不复杂,适合微服务或内部系统间通信。选择合适库后,只需定义方法并启动服务即可。关键是确保客户端和服务端都遵循 JSON-RPC 协议格式。不复杂但容易忽略细节,比如参数类型和错误编码。











