Python的xmlrpc模块提供基于HTTP+XML的轻量跨语言RPC,服务器用SimpleXMLRPCServer注册实例并serve_forever,客户端用ServerProxy调用;支持int/float/str/bool/datetime/bytes/list/dict(key须为str),不支持set/tuple/自定义类,大文件传输不适用。

Python 的 xmlrpc 模块(标准库中的 xmlrpc.server 和 xmlrpc.client)提供了一种轻量、跨语言的远程过程调用方式,适合简单服务场景。它基于 HTTP + XML,无需额外依赖,开箱即用。
服务器端:用 SimpleXMLRPCServer(Python 3.12+ 已改名)
在 Python 3.12 之前,常用 SimpleXMLRPCServer;3.12 起已移入 xmlrpc.server,类名改为 SimpleXMLRPCServer(路径不变,只是模块位置调整)。以下写法兼容 3.9–3.12:
- 定义一个普通函数(如
add(a, b)),它将作为可被远程调用的方法 - 创建服务器实例,绑定到本地地址和端口(如
localhost:8000) - 用
register_function()注册函数,或用register_instance()注册整个对象(推荐后者,便于组织多个方法) - 调用
serve_forever()启动阻塞式服务
示例(server.py):
from xmlrpc.server import SimpleXMLRPCServer import timeclass Calculator: def add(self, a, b): return a + b def now(self): return time.ctime()
server = SimpleXMLRPCServer(("localhost", 8000)) server.register_instance(Calculator()) print("XML-RPC server running on https://www.php.cn/link/d62bd5e1be9a157e45aed37bd98743c2") server.serve_forever()
客户端:用 ServerProxy 调用远程方法
客户端只需用 xmlrpc.client.ServerProxy 连接服务器 URL,之后像调用本地对象一样使用点号语法访问方法。
立即学习“Python免费学习笔记(深入)”;
- URL 格式为
http://host:port/(末尾斜杠不能少) - 调用会自动序列化参数、发送 HTTP POST 请求、解析 XML 响应
- 若服务器不可达、方法不存在或参数类型不匹配,会抛出
Fault、ProtocolError或ConnectionError
示例(client.py):
专为中小型企业定制的网络办公软件,富有竞争力的十大特性: 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装,建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件,使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件,提供web方式的远程邮件服务。 4、集成语音会议组件,节省长途话费开支。 5、集成手机短信组件,重要信息可直接发送到员工手机。 6、集成网络硬
import xmlrpc.clientproxy = xmlrpc.client.ServerProxy("https://www.php.cn/link/d62bd5e1be9a157e45aed37bd98743c2")
print(proxy.add(3, 5)) # 输出: 8 print(proxy.now()) # 输出: Wed Apr 10 15:22:33 2024
支持的数据类型与注意事项
XML-RPC 只支持有限的原生类型:int、float、string、boolean、datetime、bytes(Python 3 中对应 bytes)、list、dict(键必须是 string)。不支持 set、tuple(会被转成 list)、自定义类、None(但可传 None,服务器端收到的是 None,客户端也能接收)。
- 字典的 key 必须是字符串,否则序列化失败
- datetime 对象会被自动转成
DateTime类型,在客户端收到的是xmlrpc.client.DateTime实例,可用.value获取 ISO 字符串,或转成datetime:datetime.strptime(dt.value, "%Y%m%dT%H:%M:%S") - 大文件传输不适合 XML-RPC(XML 开销大、无流式支持),建议改用 HTTP 文件上传或 gRPC
加个简单认证(可选)
XML-RPC 协议本身不带认证,但可通过 HTTP Basic Auth 包装:
- 服务器端需配合 WSGI 或用
http.server自定义 handler 实现 auth(标准SimpleXMLRPCServer不支持) - 更简单的方式:客户端在 URL 中嵌入凭证,如
"http://user:pass@localhost:8000/"(仅限测试,不安全) - 生产环境建议加反向代理(如 Nginx)做 Basic Auth 或 JWT 验证
基本上就这些。不复杂但容易忽略细节——比如 URL 斜杠、字典 key 类型、datetime 处理。跑通 hello world 后,扩展业务逻辑只需往注册对象里加方法即可。









