.NET Core 6中如何使用XML-RPC对接API？相关包是否已弃用？

很多人搜到的老牌XML-RPC开发包标记弃用，基本都是原作者停更了仅支持.NET Framework的初始版本，不代表.NET 6环境下没有可用方案，下面两种路径都经过生产环境验证，可以按需选择：

方案1：使用社区维护的兼容移植版第三方库 #

原经典XML-RPC库有多个社区fork版本已经适配了.NET Standard 2.0/2.1，可以直接在.NET 6环境下无修改运行，API和原版完全一致，老项目迁移几乎零成本。
实现步骤：

• 从Nuget安装近2年有更新、明确标注支持.NET 6的XML-RPC移植包，注意避开2010年前后停更的仅支持.NET Framework的原版包。
• 按照对接的API定义对应C#接口契约，通过特性标记绑定端点地址、方法名：

// 接口需要继承库提供的IXmlRpcProxy基接口
[XmlRpcUrl("https://对接的API服务RPC端点地址")]
public interface IBusinessXmlRpcApi : IXmlRpcProxy
{
    // 特性参数填XML-RPC协议里定义的方法名
    [XmlRpcMethod("order.queryDetail")]
    Task<OrderDetail> QueryOrderDetail(string orderId);
}

• 调用库提供的代理生成方法拿到接口实例，直接像调用本地方法一样发请求即可，库会自动完成XML序列化、请求发送、响应解析、错误码转换的全流程：

var rpcApi = XmlRpcProxyGen.Create<IBusinessXmlRpcApi>();
// 直接调用即可拿到返回结果
var orderDetail = await rpcApi.QueryOrderDetail("ORDER20240001");

这个方案适合接口数量多、参数/返回值结构复杂的场景，开发效率高，常规的类型映射、嵌套结构、数组处理都已经封装好了，不需要自己写重复逻辑。

方案2：零依赖手写轻量实现 #

如果团队对第三方依赖管控严格，或者只需要调用少量简单接口，完全可以自己实现XML-RPC客户端，整个协议逻辑非常简单，基于.NET 6内置的HttpClient和XML处理类就能搞定，核心代码不到200行，后续.NET版本升级也不会有兼容性问题。
核心实现逻辑：

• XML-RPC的请求格式是固定的：POST请求，Content-Type为text/xml，请求体XML根节点为<methodCall>，子节点<methodName>存调用的方法名，<params>节点按顺序存所有参数，每个参数包裹在<param><value>标签下，不同数据类型对应固定的子标签（字符串对应<string>、整数对应<int>、布尔值对应<boolean>、结构体对应<struct>、数组对应<array>）。
• 响应格式固定：根节点为<methodResponse>，如果返回错误会包含<fault>节点，正常返回则在<params>节点下包裹返回值。
  最简调用实现示例：

// 注入全局复用的HttpClient即可
private readonly HttpClient _httpClient;

public async Task<TResult> CallRpcAsync<TResult>(string endpoint, string methodName, params object[] parameters)
{
    // 构造XML请求体
    var requestXDoc = new XDocument(
        new XElement("methodCall",
            new XElement("methodName", methodName),
            new XElement("params",
                parameters.Select(p => new XElement("param",
                    new XElement("value", SerializeToXmlValue(p))
                ))
            )
        )
    );
    // 发送请求
    using var content = new StringContent(requestXDoc.ToString(), Encoding.UTF8, "text/xml");
    var responseMsg = await _httpClient.PostAsync(endpoint, content);
    var responseContent = await responseMsg.Content.ReadAsStringAsync();
    // 解析响应、反序列化成目标类型即可
    return DeserializeFromXmlValue<TResult>(responseContent);
}

如果对接的接口用到了特殊类型（比如日期、base64二进制、空值），只需要在序列化/反序列化方法里补对应标签的处理规则即可，灵活度比第三方库更高。

选型建议 #

• 对接接口数量多、结构复杂，优先选社区维护的兼容库，省掉重复造轮子的成本；
• 接口少、依赖管控严格，选手写实现，完全可控，没有后续依赖弃用的隐患。

内容的提问来源于stack exchange，提问作者DenCowboy