Refit中Multipart/FromForm方法无法使用复杂请求对象的问题

结论：Refit的[Multipart]特性默认确实不支持直接传入复杂请求对象作为multipart表单的载体，这和它处理multipart/form-data请求的底层逻辑有关，和JSON Body的处理机制完全不同。

原因分析 #

• 对于无[Multipart]标记的JSON Body请求，Refit默认会把复杂对象序列化为JSON字符串放到请求体里，这是它的标准行为；
• 但标记[Multipart]后，Refit的默认逻辑是把方法的单个参数逐个映射为multipart表单字段，不会自动遍历复杂对象的属性来生成对应的表单键值对；
• 另外，你在SomeComplexRequest类上标注的[FromForm]是给ASP.NET Core服务端接收用的，Refit作为客户端并不会识别这个属性，所以也不会帮你解析对象属性为表单字段。

可行解决方案 #

方式1：自定义参数绑定器 #

实现Refit的IFormFileDataBoundProperty接口，让它能自动把复杂对象的属性转换为multipart表单字段，还能顺便处理Guid类型的转换：

public class MultipartFormObjectBinder : IFormFileDataBoundProperty
{
    public IEnumerable<MultipartFormDataContent> Bind(object? value, PropertyInfo propertyInfo, Type type)
    {
        if (value == null) yield break;
        
        var properties = type.GetProperties(BindingFlags.Public | BindingFlags.Instance);
        foreach (var prop in properties)
        {
            var propValue = prop.GetValue(value);
            if (propValue == null) continue;
            
            // 处理Guid类型，转成字符串
            var fieldValue = propValue is Guid guid ? guid.ToString() : propValue.ToString();
            // 生成表单字段，这里可以对应服务端的Name属性（比如你的"SomeID"）
            var content = new MultipartFormDataContent(new StringContent(fieldValue))
            {
                Headers = { ContentDisposition = new ContentDispositionHeaderValue("form-data") { Name = prop.Name } }
            };
            yield return content;
        }
    }
}

然后在Refit接口的参数上标记[MultipartFormContent]（确保Refit版本在较新的稳定版，这个特性已经支持很久了）：

[Post("/api/SomeController/someRoute")]
[Multipart]
Task<ApiResponse<IEnumerable<SomeResponse>>> GetSomething([MultipartFormContent] SomeComplexRequest request);

方式2：手动构建MultipartFormDataContent #

如果不想写自定义绑定器，也可以直接手动构建multipart内容，通过HttpContent参数传递：

// Refit接口定义
[Post("/api/SomeController/someRoute")]
Task<ApiResponse<IEnumerable<SomeResponse>>> GetSomething(HttpContent content);

调用时构建内容：

var request = new SomeComplexRequest(someId, offset, length);
var multipartContent = new MultipartFormDataContent();
multipartContent.Add(new StringContent(request.SomeID.ToString()), "SomeID");
multipartContent.Add(new StringContent(request.Offset.ToString()), "Offset");
multipartContent.Add(new StringContent(request.Length.ToString()), "Length");

var response = await refitClient.GetSomething(multipartContent);

补充说明 #

• 关于Guid类型：Refit本身可以支持Guid参数，只要在传递时转成字符串即可，之前的问题本质是multipart模式下默认不会自动序列化Guid，不是Refit不支持Guid类型；
• JSON Body和multipart的核心差异：前者是对象序列化，后者是键值对结构，所以Refit对两者的参数处理逻辑完全不同，这也是为什么JSON Body能直接传复杂对象，而multipart默认不行。

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