C#使用RestClient发起POST请求传递XML文件及接收为null的问题排查

• 请求格式冲突：AddFile()方法会自动将请求切换为multipart/form-data格式的文件上传模式，和手动设置的application/xml请求头不匹配；且手动设置的请求头会被AddFile自带的multipart边界配置覆盖，根本不会生效
• 参数绑定逻辑错配：后端接口的XDocument参数，默认绑定规则是直接从原始请求正文解析XML内容完成反序列化，不会主动拆解multipart表单结构、读取上传文件内容做参数绑定，因此无论传什么，这个参数都会是null
• 无效配置：设置RequestFormat = DataFormat.Xml后，没有通过AddBody()将XML内容写入请求体，该配置完全不会生效

根据实际业务场景二选一实现即可：

场景1：需要发送纯XML格式的请求体（无文件上传表单） #

调整客户端代码，去掉AddFile的文件上传逻辑，直接读取XML内容写入请求体：

public void SendXmlToApi()
{
    var client = new RestClient(_uri);
    var request = new RestRequest(Method.POST);
    // 读取本地XML文件的文本内容
    string xmlContent = File.ReadAllText(XmlPath);
    // 将XML内容写入请求体，RestSharp会自动配置正确的application/xml请求头
    request.AddBody(xmlContent, ContentType.Xml);
    var response = client.Execute(request);
    bool res = (response.StatusCode == HttpStatusCode.OK);
}

同时后端需确认XML模型绑定已开启：在服务注册环节添加XML格式化器支持，否则默认不会解析XML格式的请求体：

// ASP.NET Core 6+ 示例配置
builder.Services.AddControllers()
    .AddXmlSerializerFormatters();

此时后端接口的XDocument a参数就能正常绑定到请求体里的XML内容。

场景2：业务逻辑就是要上传XML格式的文件 #

调整后端的接收逻辑，不要直接绑定XDocument参数，改为通过IFormFile接收上传的文件，再从文件流中解析为XDocument；注意方法参数名需要和客户端传递的文件字段名完全匹配：

[HttpPost]
[Route("Test")]
public void UpdateResult(IFormFile Xml)
{
    if (Xml == null || Xml.Length == 0)
    {
        return;
    }
    // 从上传的文件流中加载XML内容
    using var stream = Xml.OpenReadStream();
    XDocument doc = XDocument.Load(stream);
    // 后续业务处理
}

此时客户端的AddFile("Xml", XmlPath)逻辑不需要调整，即可完成正常绑定。

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