C# WebAPI上传含Stream的MultipartFormDataContent时Stream映射为空问题

问题背景 #

你的ASP.NET Core WebAPI在接收Multipart表单上传时遇到两个问题：

1. 默认返回400 Bad Request，添加全局配置builder.Services.AddControllers(options => options.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true)后可进入接口，但filecontent字段始终为null（其余字段能正常赋值），抓包确认文件流已包含在请求中。
2. 直接使用Stream类型无法完成表单文件的模型绑定。

核心解决方案 #

ASP.NET Core的FromForm模型绑定不支持直接将上传文件映射到Stream类型，需要改用框架提供的IFormFile类型来封装上传的文件数据。

步骤1：修改实体类字段类型 #

将UploadContent中的Stream类型字段替换为IFormFile：

public class UploadContent
{
    public string? Id { get; set; } // 改为可空类型，避免非空引用类型隐式触发Required校验导致400
    public string? Name { get; set; }
    public IFormFile filecontent { get; set; } // 替换Stream为IFormFile
}

步骤2：调整服务端接口（按需读取文件流） #

在接口中可以通过IFormFile.OpenReadStream()获取文件流进行后续处理：

[HttpPost]
public IActionResult Upload([FromForm] UploadContent input)
{
    if (input.filecontent == null)
    {
        return BadRequest("未上传文件");
    }
    
    // 读取文件流示例
    using var fileStream = input.filecontent.OpenReadStream();
    // 这里可以添加文件保存、内容解析等逻辑
    
    return Ok("upload ok");
}

可选：优化400错误的处理方式 #

如果不想全局关闭非空引用类型的隐式Required校验，可以给需要允许空值的字段添加[Required(AllowEmptyStrings = true)]标记，或者将字段设为可空类型（如上述代码中的string?），这样更精准地控制校验规则。

额外说明 #

1. 客户端代码无需修改：你当前的客户端Multipart表单构造逻辑是正确的，IFormFile可以自动绑定请求中的文件部分。
2. 可移除客户端不必要的请求头：http.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("multipart/form-data"))可以删除，因为Accept头用于指定客户端接受的响应类型，与请求本身的multipart/form-data类型无关。

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