XML-RPC（XML Remote Procedure Call）是一种基于XML编码、以HTTP为传输载体的远程过程调用协议。它把客户端发起的调用序列化为XML格式的请求，服务端解析请求并执行对应方法，再把结果封装为XML响应返回。Python标准库中的xmlrpc模块为这一协议提供了完整的、开箱即用的实现，开发者无需安装任何第三方依赖，即可快速搭建XML-RPC服务端和客户端。该模块由两个子模块构成，分别是负责服务端能力的xmlrpc.server和负责客户端能力的xmlrpc.client。由于协议只依赖HTTP和XML，它天然适合跨语言、跨进程、跨主机的轻量级服务集成，在内部系统、监控组件、运维工具等场景中非常实用。
一、xmlrpc库的核心组件与协议特点
了解xmlrpc库的结构，有助于在使用过程中准确定位所需的类和方法。xmlrpc.server子模块提供创建服务端的核心类，例如SimpleXMLRPCServer，它封装了HTTP服务器逻辑，并把XML-RPC请求自动分发给已注册的函数。xmlrpc.client子模块提供创建客户端代理的ServerProxy类，它通过实现__getattr__方法，使远程方法看起来就像本地对象的方法一样可以直接调用。
XML-RPC协议对数据类型有明确的约束。请求与响应中只允许出现协议定义的基础类型，包括整数、浮点数、字符串、布尔值、数组、结构体、日期时间和二进制数据。Python的列表、字典、字符串等类型可以由xmlrpc库自动完成与XML元素之间的序列化和反序列化。这种限制让协议保持简单，同时也提醒开发者在设计远程接口时，需要把复杂业务对象转换为协议可表达的结构。
二、实现XML-RPC服务端
服务端的工作主要包括定义可被远程调用的方法、将方法注册到服务实例、启动服务监听端口。下面示例创建了两个远程方法：add用于计算两个数的和，get_user_info用于根据用户ID返回用户信息字典。这些方法本质上是普通的Python函数，并不需要继承特殊基类或使用装饰器。
from xmlrpc.server import SimpleXMLRPCServer
# 定义可被远程调用的方法
def add(a, b):
"""两个数相加"""
return a + b
def get_user_info(user_id):
"""根据用户ID获取用户信息"""
user_dict = {
1: {"name": "张三", "age": 25},
2: {"name": "李四", "age": 30}
}
return user_dict.get(user_id, {})
# 创建服务端实例，绑定本地8000端口
server = SimpleXMLRPCServer(("127.0.0.1", 8000))
# 注册远程方法
server.register_function(add, "add")
server.register_function(get_user_info, "get_user_info")
print("XML-RPC服务端已启动，监听127.0.0.1:8000")
# 启动服务，持续监听请求
server.serve_forever()
上述代码中，SimpleXMLRPCServer绑定到127.0.0.1的8000端口。register_function方法把本地函数注册为远程方法，第二个参数指定远程调用时使用的方法名称。serve_forever方法启动阻塞式服务循环，持续处理客户端请求。基础版本的SimpleXMLRPCServer默认采用单线程方式处理请求，如果多个客户端同时调用，后续请求会等待前一个请求处理完毕。
对于需要并发处理的场景，可以借助Python标准库socketserver模块中的ThreadingMixIn与SimpleXMLRPCServer组合，创建多线程XML-RPC服务端。这样每个请求会由独立线程处理，从而提升并发能力。需要注意的是，注册到多线程服务端的方法必须保证线程安全。
from xmlrpc.server import SimpleXMLRPCServer
from socketserver import ThreadingMixIn
# 定义多线程混合类
class ThreadingXMLRPCServer(ThreadingMixIn, SimpleXMLRPCServer):
pass
def multiply(a, b):
return a * b
server = ThreadingXMLRPCServer(("127.0.0.1", 8000))
server.register_function(multiply, "multiply")
server.serve_forever()
使用多线程服务端时，ThreadingMixIn为每个连接分配独立线程，因此可以有效避免单个耗时请求阻塞其他客户端调用。对于涉及共享资源的远程方法，需要在方法内部做好同步控制，防止多个线程同时修改共享数据导致状态不一致。
三、实现XML-RPC客户端
客户端通过xmlrpc.client中的ServerProxy类创建代理对象，指定服务端HTTP地址后，即可像调用普通方法一样调用远程方法。下面示例连接本机的8000端口，依次调用服务端注册的add、get_user_info和multiply方法。
from xmlrpc.client import ServerProxy
# 创建客户端代理，指向服务端地址
client = ServerProxy("http://127.0.0.1:8000")
# 调用远程方法add
result1 = client.add(3, 5)
print(f"3 + 5 = {result1}")
# 调用远程方法get_user_info
result2 = client.get_user_info(1)
print(f"用户ID为1的信息：{result2}")
# 调用多线程服务端的multiply方法
result3 = client.multiply(4, 6)
print(f"4 * 6 = {result3}")
在上面的代码中，client.add(3, 5)并不会在本地执行加法，而是由ServerProxy把方法名和参数编码为XML-RPC请求，发送给服务端，再解析返回结果。整个过程对调用方透明，这正是XML-RPC远程过程调用的核心价值。如果调用的方法携带Python列表或字典，xmlrpc.client会自动将其序列化为XML-RPC的数组和结构类型，服务端返回的响应也会按照对应类型解析回Python对象。XML-RPC协议规定了几种核心数据类型，Python标准库中的xmlrpc.client和xmlrpc.server会自动完成这些类型与Python内置类型之间的相互转换。
常用类型映射如下：
- XML-RPC int/i4/i8 对应 Python int
- XML-RPC boolean 对应 Python bool
- XML-RPC string 对应 Python str
- XML-RPC double 对应 Python float
- XML-RPC array 对应 Python list 或 tuple
- XML-RPC struct 对应 Python dict
- XML-RPC dateTime.iso8601 对应 xmlrpc.client.DateTime 对象
- XML-RPC base64 对应 xmlrpc.client.Binary 对象
因此当客户端调用远程方法并传入列表或字典时，序列化过程对调用方透明；服务端返回的数组和结构也会被还原成Python的list和dict。下面示例演示传递复杂参数：
# 客户端发送列表和字典参数
data_list = ["apple", "banana", "cherry"]
config_dict = {"debug": True, "retry": 3, "ratio": 0.75}
reply = client.process_data(data_list, config_dict)
print("服务端返回：", reply)
服务端需要在register_instance所属类中实现process_data方法，接收的参数类型与客户端发送的类型一致。
异常处理与错误诊断
远程调用过程中可能出现多种错误：网络中断、服务端方法不存在、业务逻辑异常等。xmlrpc.client提供了Fault和ProtocolError两个异常类，可以分别用于处理服务端业务错误和HTTP协议层错误。
from xmlrpc.client import ServerProxy, Fault, ProtocolError
client = ServerProxy("http://127.0.0.1:8000")
try:
result = client.divide(10, 0)
except Fault as e:
print(f"远程方法返回错误：faultCode={e.faultCode}, faultString={e.faultString}")
except ProtocolError as e:
print(f"协议错误：HTTP状态码={e.errcode}, 原因={e.errmsg}")
except Exception as e:
print(f"调用失败：{e}")
服务端若在方法中抛出异常，xmlrpc.server会将其转换为Fault响应，客户端捕获到Fault后可以读取faultCode和faultString了解具体原因。例如服务端divide方法：
from xmlrpc.server import SimpleXMLRPCServer
def divide(a, b):
if b == 0:
raise ValueError("除数不能为零")
return a / b
server = SimpleXMLRPCServer(("127.0.0.1", 8000))
server.register_function(divide, "divide")
server.serve_forever()
此时客户端除零调用会触发Fault异常，faultString为“除数不能为零”。这种机制使错误信息能够跨语言、跨机器传递。
二进制数据传输
XML-RPC本身基于文本传输，文件或图片等二进制数据需要包装为xmlrpc.client.Binary对象。服务端返回二进制数据时，客户端也会得到Binary对象，通过其data属性可以获取原始字节。
import xmlrpc.client
from xmlrpc.client import Binary
client = ServerProxy("http://127.0.0.1:8000")
# 上传文件
with open("example.png", "rb") as f:
file_bytes = Binary(f.read())
client.upload("example.png", file_bytes)
# 下载文件
download_result = client.download("example.png")
with open("downloaded.png", "wb") as f:
f.write(download_result.data)
在服务端下实现upload和download方法时，上传参数会是Binary对象，需要使用其data属性获取字节；返回数据时也应返回Binary对象。为了安全，实际项目中还需要校验文件类型、大小和路径，防止任意文件读写。
安全注意事项
XML-RPC默认使用明文HTTP传输，数据在网络中不具备机密性和完整性保护。生产环境应尽量使用HTTPS，并对服务端进行身份认证和授权。可以使用反向代理（如Nginx）提供TLS终结，或在xmlrpc.server前架设HTTP Basic Auth中间件。此外，服务端监听地址不宜直接绑定0.0.0.0暴露到公网，建议只监听内网地址或使用防火墙限制来源IP。
对于多线程服务端，尤其要注意远程方法内部的线程安全。共享可变状态必须使用锁或其他同步机制，避免并发修改导致数据竞争。以下为加锁的简单示例：
import threading
from xmlrpc.server import SimpleXMLRPCServer
from socketserver import ThreadingMixIn
class ThreadingXMLRPCServer(ThreadingMixIn, SimpleXMLRPCServer):
pass
lock = threading.Lock()
counter = 0
def increment():
global counter
with lock:
counter += 1
return counter
server = ThreadingXMLRPCServer(("127.0.0.1", 8000))
server.register_function(increment, "increment")
server.serve_forever()
这里通过with lock保证自增操作的原子性，使并发调用不会丢失计数。
小结
本文从XML-RPC的基础概念出发，介绍了使用Python标准库搭建XML-RPC服务端和客户端的完整流程。通过SimpleXMLRPCServer注册方法、结合ThreadingMixIn实现多线程处理，能够快速构建跨语言可访问的远程过程调用接口。客户端使用ServerProxy以近乎本地方法调用的方式访问远程服务，列表、字典等数据结构自动完成序列化与反序列化。在实际开发中，还需要关注异常处理、二进制数据传输以及安全防护等方面。掌握这些内容后，便可基于XML-RPC实现简单、稳定的分布式系统通信。