XML-RPC 是一个具体协议标准，非通用方法，需严格遵循 methodCall 结构、九种固定类型及传输规则，现代已基本弃用，仅存于遗留系统。
XML-RPC 不是“用 XML 进行远程过程调用”的通用方法，而是一个**具体协议标准**，有固定结构、方法名约定和传输规则。它早已被主流服务弃用，仅在遗留系统（如旧版 WordPress、某些嵌入式设备 API）中可见。
XML-RPC 的请求必须符合 methodCall 格式
客户端不能随便发一段 XML 就算调用；必须包裹在 <methodcall></methodcall> 根元素下，并严格包含 <methodname></methodname> 和 <params></params>。参数类型也受限：只支持 string、i4、int、boolean、double、dateTime.iso8601、base64、array、struct 九种，没有 null、undefined、NaN 或自定义对象。
- 错误示例：
<user><id>123</id><name>Alice</name></user>
—— 这只是普通 XML，不是 XML-RPC 请求 - 正确结构：
<methodCall> <methodName>metaWeblog.newPost</methodName> <params> <param><value><string>1</string></value></param> <param><value><struct> <member><name>title</name><value><string>Hello</string></value></member> </struct></value></param> </params> </methodCall>
Python 中用 xmlrpc.client 调用最稳妥
手动拼 XML 容易出错，且要处理 HTTP 头（Content-Type: text/xml、Content-Length）、编码、超时等细节。标准库 xmlrpc.client 自动完成序列化、HTTP POST、响应解析，还内置类型映射（如 Python datetime → dateTime.iso8601）。
- 必须用
ServerProxy初始化，URL 后缀通常为/RPC2或/xmlrpc.php - 方法调用直接写成
proxy.method_name(arg1, arg2)，不需手动构造 XML - 服务器返回的
struct自动转为 Pythondict，array转为list - 遇到
Fault异常（如xmlrpc.client.Fault: <fault api key></fault>）说明服务端拒绝，不是网络问题
import xmlrpc.client
<p>proxy = xmlrpc.client.ServerProxy('<a href="https://www.php.cn/link/499a3f88156bb6321e00d0ff0ab55041">https://www.php.cn/link/499a3f88156bb6321e00d0ff0ab55041</a>')
try:
post_id = proxy.metaWeblog.newPost(
'1', # blog_id
'admin', 'password',
{
'title': 'First Post',
'description': '<p>Hello world</p>'
},
True # publish
)
print(f'Posted: {post_id}')
except xmlrpc.client.Fault as e:
print(f'Server error: {e.faultString}') # 直接拿到错误描述常见失败原因不是 XML 写错，而是协议/认证层面卡住
90% 的“XML-RPC 调用失败”其实和 XML 无关，而是以下几类问题：
- HTTP 状态码非 200：比如 Nginx 返回 405（Method Not Allowed），因为 XML-RPC 只允许 POST，但服务器配置了拒绝 POST 到该路径
- SSL/TLS 不兼容：旧服务只支持 TLS 1.0/1.1，现代 Python 默认禁用；需显式设置
context=ssl.create_default_context(ssl.Purpose.CLIENT_AUTH)并降级 - 认证方式不匹配：WordPress XML-RPC 需用户密码，但有些系统要求 App Password 或 OAuth token，直接传账号密码会 403
- 防火墙或 CDN 拦截：Cloudflare 默认屏蔽
POST /xmlrpc.php（防爆破），需在 WAF 规则中放行
XML-RPC 的真正难点不在“怎么写 XML”，而在确认目标服务是否真接受它、用什么认证、走哪条路径、以及如何让现代客户端绕过 TLS 或代理限制。一旦握手成功，后续调用反而比 REST 更机械——毕竟连 URL 路由都省了，全靠 methodName 字符串分发。
