ApiController收发含字节数组的FileParameter对象失败求助

核心问题分析 #

你的代码存在3个关键问题，导致数据接收失败或415错误：

1. 文件内容的ContentType设置错误，误用了表单编码类型而非文件实际类型
2. 向MultipartFormData添加文件时未指定文件名参数，模型绑定无法正确识别字段
3. 异步操作误用同步等待（.Result），且循环内重复创建HttpClient造成资源浪费

修正后的代码 #

控制器代码（保持[FromForm]，补充路由校验） #

[HttpPost]
[Route("api/Calculator/GetFileOIT")] // 确保路由与客户端请求路径匹配
public IActionResult GetFileOIT([FromForm] FileParameter fileParameter)
{
    try
    {
        if (fileParameter.File == null || string.IsNullOrEmpty(fileParameter.FileName))
        {
            return BadRequest("文件或文件名不能为空");
        }
        string x = fileParameter.FileName;
        // 后续业务逻辑处理
    }
    catch (Exception ex)
    {
        return BadRequest(ex.Message);
    }

    return Ok();
}

客户端修正代码 #

// 复用HttpClient，避免循环内重复创建消耗连接池
using var client = new HttpClient();
client.BaseAddress = new Uri("http://localhost:5074/");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

foreach (FileParameter item in files)
{
    using var multiForm = new MultipartFormDataContent();
    
    // 添加FileName字段，用属性名确保绑定匹配
    multiForm.Add(new StringContent(item.FileName ?? string.Empty), nameof(FileParameter.FileName));
    
    // 添加ContentType字段
    multiForm.Add(new StringContent(item.ContentType ?? "application/octet-stream"), nameof(FileParameter.ContentType));
    
    // 修正文件内容的ContentType，并指定文件名参数
    var bytes = new ByteArrayContent(item.File ?? Array.Empty<byte>());
    bytes.Headers.ContentType = MediaTypeHeaderValue.Parse(item.ContentType ?? "application/octet-stream");
    // 第三个参数为文件名，是模型绑定识别File属性的关键
    multiForm.Add(bytes, nameof(FileParameter.File), item.FileName);

    try
    {
        // 用await替代.Result，避免线程死锁
        HttpResponseMessage httpResponseMessage = await client.PostAsync("api/Calculator/GetFileOIT", multiForm);

        if (httpResponseMessage.IsSuccessStatusCode)
        {
            var response = await httpResponseMessage.Content.ReadAsStringAsync();
            // 处理成功响应逻辑
        }
        else
        {
            var content = await httpResponseMessage.Content.ReadAsStringAsync();
            // 处理错误响应逻辑
        }
    }
    catch (Exception ex)
    {
        // 捕获请求异常并处理
    }
}

关键修正点说明 #

• ContentType调整：文件内容的ContentType要匹配实际文件类型（如图片用image/jpeg，通用二进制文件用application/octet-stream），不能用表单编码类型application/x-www-form-urlencoded
• Multipart文件绑定：添加文件时必须指定第三个参数（文件名），ASP.NET Core的模型绑定才能将其映射到File属性
• HttpClient复用：循环内重复创建HttpClient会耗尽连接池，复用单个实例是最佳实践
• 异步操作规范：使用await替代.Result，避免UI线程死锁问题

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