ASP.NET Core+Swagger中IFormFile与[FromBody]参数始终为Null的问题

你碰到的这个问题其实是ASP.NET Core请求处理的一个常见限制：一个HTTP请求只能包含一个请求体。当你在方法里同时声明IFormFile（对应multipart/form-data类型的请求，用来上传文件）和[FromBody] ContentDTO（期望请求体是JSON/XML这类结构化数据）时，这两种格式是互斥的——框架没法同时解析multipart/form-data的表单数据和JSON请求体，所以ContentDTO就会被解析为null。

根据你的需求（同时传文件和DTO数据），推荐两种可行的方案：

方案1：将DTO和文件放在同一个multipart/form-data表单中 #

这种方式是最常用的文件上传+参数传递的方案，不需要用[FromBody]，而是让ContentDTO和IFormFile一起作为表单字段传递：

修改你的控制器方法：

[HttpPost]
[Route("add-content")]
public async Task AddContent(IFormFile uploadedFile, [FromForm] ContentDTO content) 
{
    var fileName = Guid.NewGuid() + "-" + uploadedFile.FileName;
    // 注意路径拼接用Path.Combine更安全，避免硬编码的路径分隔符问题
    var path = Path.Combine(Directory.GetCurrentDirectory(), "UplodedFiles", "ContentFiles", fileName);
    
    using (var stream = new FileStream(path, FileMode.Create))
    {
        await uploadedFile.CopyToAsync(stream);
    }
    // 后续处理content的逻辑
}

注：[FromForm]特性其实可以省略，因为ASP.NET Core对于非复杂类型和IFormFile以外的复杂类型，默认就是从表单绑定的。

在Swagger中测试时，选择multipart/form-data类型，然后分别上传文件、填写ContentDTO的各个字段即可，Swagger会自动识别并生成对应的表单项。

方案2：将DTO序列化为JSON字符串放在表单中（适合DTO结构复杂的场景） #

如果你的ContentDTO结构比较复杂，不想拆分成单个表单字段，可以把它序列化为JSON字符串，放在表单的一个单独字段里，然后在控制器中手动反序列化：

控制器方法修改如下：

using System.Text.Json;

[HttpPost]
[Route("add-content")]
public async Task AddContent(IFormFile uploadedFile, string contentJson) 
{
    // 反序列化JSON字符串为ContentDTO对象
    var content = JsonSerializer.Deserialize<ContentDTO>(contentJson);
    if (content == null)
    {
        // 处理反序列化失败的情况
        return BadRequest("Invalid content data");
    }
    
    var fileName = Guid.NewGuid() + "-" + uploadedFile.FileName;
    var path = Path.Combine(Directory.GetCurrentDirectory(), "UplodedFiles", "ContentFiles", fileName);
    
    using (var stream = new FileStream(path, FileMode.Create))
    {
        await uploadedFile.CopyToAsync(stream);
    }
    // 后续处理逻辑
}

测试时在Swagger的form-data里添加contentJson字段，填入ContentDTO的JSON字符串即可。

不推荐的方案：将文件转为Base64放在DTO中 #

如果你的文件很小，可以把文件转成Base64字符串，放在ContentDTO里，然后用[FromBody]传递整个DTO。但这种方式会让文件体积增大30%左右，而且不适合大文件上传，所以只推荐小文件场景：

修改ContentDTO：

public class ContentDTO
{
    // 你的原有字段
    public string Title { get; set; }
    public string Description { get; set; }
    
    // 文件相关字段
    public string FileBase64 { get; set; }
    public string FileName { get; set; }
}

控制器方法：

[HttpPost]
[Route("add-content")]
public async Task AddContent([FromBody] ContentDTO content) 
{
    if (content == null || string.IsNullOrEmpty(content.FileBase64))
    {
        return BadRequest("Invalid content or file data");
    }
    
    var fileBytes = Convert.FromBase64String(content.FileBase64);
    var path = Path.Combine(Directory.GetCurrentDirectory(), "UplodedFiles", "ContentFiles", content.FileName);
    
    await File.WriteAllBytesAsync(path, fileBytes);
    // 后续处理逻辑
}

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