17370845950

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 time
class 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./link/d62bd5e1be9a157e45aed37bd98743c2")
server.serve_forever()

客户端：用 ServerProxy 调用远程方法

客户端只需用 xmlrpc.client.ServerProxy 连接服务器 URL，之后像调用本地对象一样使用点号语法访问方法。

• URL 格式为 http://host:port/（末尾斜杠不能少）
• 调用会自动序列化参数、发送 HTTP POST 请求、解析 XML 响应
• 若服务器不可达、方法不存在或参数类型不匹配，会抛出 Fault、ProtocolError 或 ConnectionError

示例（client.py）：

import xmlrpc.client
proxy = xmlrpc.client.ServerProxy("https://www./link/d62bd5e1be9a157e45aed37bd98743c2")
print(proxy.add(3, 5))      # 输出: 8
print(proxy.now())          # 输出: Wed Apr 10 15:22:33 2025

支持的数据类型与注意事项

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 后，扩展业务逻辑只需往注册对象里加方法即可。