如何使用HttpClient将IFormFile发送至指定ASP.NET Core POST端点？

场景说明 #

后端端点定义 #

后端有一个接收IFormFile的POST端点，请求模型同时包含路由参数和表单文件：

[HttpPost]
public async Task<ActionResult<MyResponse>> Post([FromRoute] MyRequest request, CancellationToken cancellationToken = default)
{
       ...
}
public class MyRequest 
{
   [FromForm]
   public IFormFile File { get; set; }     

   [FromRoute(Name = "userId")]
   public string UserId{ get; set; }
}

客户端已准备的IFormFile实例 #

客户端已创建测试用的IFormFile对象：

var bytes = Encoding.UTF8.GetBytes("This is a dummy file");
IFormFile file = new FormFile(new MemoryStream(bytes), 0, bytes.Length, "File", "dummy.txt");

问题 #

如何使用HttpClient将这个IFormFile正确发送到上述POST端点？

已尝试的代码（无法正常工作） #

var url = "";
var streamContent = new StreamContent(file.OpenReadStream(), 4069);
var httpClient = new HttpClient();
await httpClient.PostAsync($"{url}", streamContent);

正确解决方案 #

你之前的代码问题在于直接发送流内容，未按multipart/form-data格式组织请求，后端无法将其解析为IFormFile，同时也未在URL中携带路由参数userId。正确实现步骤如下：

1. 构造包含路由参数的完整URL
   根据后端的路由规则，把实际的userId填充到URL中，比如后端路由为/api/users/{userId}/upload，则需生成对应格式的完整请求地址。

2. 使用MultipartFormDataContent包装表单数据
   由于后端用[FromForm]接收文件，必须采用multipart表单格式发送请求，这是文件上传的标准格式。

3. 将文件添加到表单内容中
   需指定与MyRequest中File属性名一致的表单字段名，同时带上文件名。

完整代码示例 #

// 替换为实际的userId和后端基础URL
string userId = "12345";
string baseUrl = "https://your-api-domain.com/api/users";
string fullUrl = $"{baseUrl}/{userId}/upload"; // 匹配后端路由结构

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

// 添加文件到表单，name参数需与MyRequest的File属性名完全匹配
using var fileStream = file.OpenReadStream();
var fileContent = new StreamContent(fileStream);
// 根据实际文件类型设置Content-Type，这里以文本文件为例
fileContent.Headers.ContentType = new MediaTypeHeaderValue("text/plain");
formContent.Add(fileContent, name: "File", fileName: file.FileName);

// 发送POST请求
var response = await httpClient.PostAsync(fullUrl, formContent);

// 可选：验证响应状态
response.EnsureSuccessStatusCode();
var responseContent = await response.Content.ReadAsStringAsync();

关键说明 #

• 必须使用MultipartFormDataContent，ASP.NET Core的[FromForm]仅能解析这种格式的文件上传请求。
• URL中必须包含userId参数，否则后端无法绑定MyRequest中的UserId属性。
• 添加文件时的name参数要和MyRequest里的File属性名称完全一致，否则后端无法正确接收文件。

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