求助：通过HttpClient上传IFormFile至WebApi时遇NotSupportedException错误

嘿，这个坑我之前踩过也帮不少朋友解决过！你遇到的System.NotSupportedException根源在于：你大概率尝试直接序列化IFormFile对象来发送请求，但IFormFile的Headers属性是IHeaderDictionary接口类型，默认的JSON序列化器（不管是System.Text.Json还是Newtonsoft.Json）都没法处理这种接口的序列化，所以才抛出了这个错误。

正确的做法是模拟浏览器的表单上传行为，用MultipartFormDataContent来构建请求——因为IFormFile本身就是为multipart/form-data类型的表单请求设计的，所以必须对应这种格式来发送。

具体实现步骤 #

1. 客户端（Web项目）代码 #

假设你已经在Web项目中拿到了IFormFile实例（比如从用户上传的表单里获取），用以下代码构建HttpClient请求：

// 示例：从当前Web请求中获取IFormFile（如果是从其他来源获取，逻辑类似）
IFormFile uploadedFile = Request.Form.Files["file"];

using var httpClient = new HttpClient();
using var multipartContent = new MultipartFormDataContent();

// 从IFormFile中读取文件流，创建StreamContent
using var fileStream = uploadedFile.OpenReadStream();
var fileContent = new StreamContent(fileStream);
// 设置文件的Content-Type，直接复用IFormFile自带的类型
fileContent.Headers.ContentType = MediaTypeHeaderValue.Parse(uploadedFile.ContentType);

// 注意：这里的第一个参数"file"必须和WebApi接口的参数名称完全匹配
multipartContent.Add(fileContent, "file", uploadedFile.FileName);

// 发送POST请求到你的WebApi上传接口
var response = await httpClient.PostAsync("https://your-api-domain/api/upload", multipartContent);
// 确保请求成功，失败会抛出异常
response.EnsureSuccessStatusCode();

// 可选：读取API返回的结果
var result = await response.Content.ReadFromJsonAsync<UploadResult>();

2. WebApi端接收代码 #

确保你的API接口用[FromForm]标记参数，明确接收表单类型的请求：

[ApiController]
[Route("api/[controller]")]
public class UploadController : ControllerBase
{
    // 上传单个文件的接口
    [HttpPost("upload")]
    public async Task<IActionResult> UploadSingleFile([FromForm] IFormFile file)
    {
        if (file == null || file.Length == 0)
        {
            return BadRequest("请选择要上传的文件");
        }

        // 示例：保存文件到服务器本地（可以替换为存储到OSS等云服务）
        var uploadDir = Path.Combine(Directory.GetCurrentDirectory(), "Uploads");
        if (!Directory.Exists(uploadDir))
        {
            Directory.CreateDirectory(uploadDir);
        }
        var savePath = Path.Combine(uploadDir, file.FileName);
        
        using var stream = new FileStream(savePath, FileMode.Create);
        await file.CopyToAsync(stream);

        return Ok(new { Message = "文件上传成功", SavePath = savePath });
    }

    // 可选：上传多个文件的接口
    [HttpPost("upload-multiple")]
    public async Task<IActionResult> UploadMultipleFiles([FromForm] IEnumerable<IFormFile> files)
    {
        // 处理多个文件的逻辑，类似单个文件的循环处理
        foreach (var file in files)
        {
            // 重复单个文件的保存逻辑
        }
        return Ok(new { Message = "所有文件上传成功" });
    }
}

关键注意点 #

• 绝对不要直接序列化IFormFile对象发送，必须用MultipartFormDataContent封装
• 客户端添加文件时的参数名称（示例中的"file"）必须和API接口的参数名完全一致
• 如果要上传多个文件，客户端可以多次调用multipartContent.Add()添加文件，API端参数改为IEnumerable<IFormFile>

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