Python的xmlrpc库提供轻量级RPC实现，基于XML和HTTP，适合简单跨语言通信；客户端用ServerProxy调用远程方法，服务端需注册函数并支持基础类型，推荐ThreadingXMLRPCServer并发。
Python 的 xmlrpc 库（即 xmlrpc.client 和 xmlrpc.server）是标准库中轻量级的远程过程调用（RPC）实现，适合简单跨语言通信或内部工具集成。它基于 XML 编码和 HTTP 传输，虽不如 REST 或 gRPC 现代，但部署简单、无需额外依赖。
XML-RPC 客户端：调用远程方法
使用 xmlrpc.client.ServerProxy 连接服务端，像调用本地函数一样调用远程方法。
基本用法示例：
import xmlrpc.client
<h1>连接服务端（假设服务运行在 <a href="https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774">https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774</a>）</h1><p>proxy = xmlrpc.client.ServerProxy('<a href="https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774">https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774</a>')</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><h1>调用远程函数（如 add、get_user）</h1><p>result = proxy.add(3, 5) # 返回 8
user = proxy.get_user(123) # 返回字典，如 {'id': 123, 'name': 'Alice'}</p><h1>支持列表、字典、整数、字符串、布尔值、None、datetime、bytes（需 base64 编码）</h1><p>proxy.echo({'msg': 'hello', 'count': 2})
</p>注意点：
- URL 必须带协议（
http://或https://），否则报错 - 服务端未启动或网络不通时，首次调用会抛出
ConnectionRefusedError或xmlrpc.client.ProtocolError - 若服务端返回结构复杂（如嵌套类实例），客户端只收到字典/列表等基础类型 —— XML-RPC 不支持任意 Python 对象序列化
- 如需超时控制，可传入
transport参数自定义（见下文进阶用法）
XML-RPC 服务端：发布可调用函数
Python 提供两种常用服务端：单线程的 SimpleXMLRPCServer（Python 3.9+ 已弃用）和推荐的 xmlrpc.server.SimpleXMLRPCServer（兼容旧版写法）；新项目建议用 ThreadingXMLRPCServer 支持并发。
简易服务端示例：
from xmlrpc.server import SimpleXMLRPCServer
from xmlrpc.server import SimpleXMLRPCRequestHandler
<h1>仅允许 /RPC2 路径访问（可选安全限制）</h1><p>class RequestHandler(SimpleXMLRPCRequestHandler):
rpc_paths = ('/RPC2',)</p><h1>创建服务端（监听 localhost:8000）</h1><p>server = SimpleXMLRPCServer(('localhost', 8000), requestHandler=RequestHandler)
server.register_introspection_functions() # 启用 system.listMethods 等调试方法</p><h1>注册函数（可直接注册普通函数）</h1><p>def add(x, y):
return x + y</p><p>def get_user(user_id):
return {'id': user_id, 'name': 'Test User', 'active': True}</p><p>server.register_function(add, 'add')
server.register_function(get_user, 'get_user')</p><h1>启动服务（阻塞式）</h1><p>print("XML-RPC server running on <a href="https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774/RPC2">https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774/RPC2</a>")
server.serve_forever()
</p>关键细节：
- 必须显式调用
register_function()才能让客户端发现并调用该函数 -
register_introspection_functions()开启内省能力（如system.listMethods），方便调试 - 默认不支持多线程，高并发场景请改用
ThreadingXMLRPCServer（继承自同名类，用法一致） - 函数参数和返回值受限于 XML-RPC 类型系统（不支持 set、tuple、自定义类等）
进阶技巧：超时、认证与自定义类型
客户端设置超时：
import xmlrpc.client
<p>class TimeoutTransport(xmlrpc.client.Transport):
def <strong>init</strong>(self, timeout=10, *args, *<em>kwargs):
self.timeout = timeout
super().<strong>init</strong>(</em>args, **kwargs)</p><pre class="brush:php;toolbar:false;">def make_connection(self, host):
conn = super().make_connection(host)
conn.timeout = self.timeout
return connproxy = xmlrpc.client.ServerProxy( 'https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774', transport=TimeoutTransport(timeout=5) )
基础认证（HTTP Basic Auth）：
- 服务端需配合 Web 服务器（如 Nginx/Apache）做认证，或自行在 handler 中解析
Authorization头 - 客户端 URL 写成
http://user:pass@localhost:8000/RPC2即可自动携带凭证（注意密码需 URL 编码）
处理 bytes 和 datetime：
-
bytes会被自动 base64 编码传输，客户端接收后仍是bytes -
datetime.datetime对象可直接传递，服务端和客户端均能正确识别（前提是双方都用 Python xmlrpc 实现）
常见问题与替代建议
典型报错：
-
xmlrpc.client.Fault：服务端抛出异常，错误信息在faultString中 -
xmlrpc.client.ProtocolError：HTTP 状态非 200（如 404、500）、响应非 XML 格式 -
ExpatError：服务端返回了非法 XML（常见于日志打印干扰响应体）
是否还该用 XML-RPC？
- 适合：内网小工具、遗留系统对接、教学演示、极简 API（无 JSON/HTTPS/路由需求）
- 不推荐：新项目对外 API、需要 RESTful 设计、需 OpenAPI 文档、要求高性能或流式传输
- 现代替代：Flask/FastAPI + JSON + HTTP（更通用）、gRPC（强类型+高效）、ZeroMQ（去中心化）
不复杂但容易忽略 —— 把好类型边界、加好超时、打开 introspection，就能稳定跑起来。
