.NET Core7 Minimal API通过Swagger上传IFormFile时文件为null

核心问题 #

在.NET Core 7 Minimal API里直接把IFormFile作为顶级参数时，模型绑定没法正确解析multipart/form-data格式的文件，导致参数始终为null。这是因为Minimal API默认的绑定规则对单个IFormFile的处理需要额外配置，或者得把它包裹在类里才能正常识别。

解决方案1：用DTO类包裹IFormFile #

创建一个包含IFormFile属性的类，把它作为接口参数，模型绑定就能正确识别文件了：

public class FileUploadDto
{
    public IFormFile File { get; set; }
}

// 修改后的接口代码
var group = app.MapGroup("Payment").WithTags("Payment").WithOpenApi();
group.MapPost("htmlToPdf", async (FileUploadDto input) =>
{
    if (input.File == null)
    {
        return Results.BadRequest("未上传文件");
    }
    // 后续业务逻辑
    ....
})
.Accepts<FileUploadDto>("multipart/form-data");

解决方案2：给参数添加[FromForm]特性 #

如果不想新建DTO类，可以直接给IFormFile参数加上[FromForm]特性，明确指定从表单数据绑定：

var group = app.MapGroup("Payment").WithTags("Payment").WithOpenApi();
group.MapPost("htmlToPdf", async ([FromForm] IFormFile file) =>
{
    if (file == null)
    {
        return Results.BadRequest("未上传文件");
    }
    // 后续业务逻辑
    ....
})
.Accepts<IFormFile>("multipart/form-data");

额外注意事项 #

• 确保Swagger UI里选择的请求类型是multipart/form-data，且文件字段名和接口参数名一致（比如方案2里参数名是file，Swagger的文件输入框字段名也要填file）
• 检查Program.cs里是否包含必要服务，Minimal API默认已经集成文件上传所需服务，但如果手动移除过相关配置，要确保添加：

  builder.Services.AddHttpContextAccessor();
  

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