ASP.NET Core Web API中Swagger UI不显示文件上传按钮问题

原因 #

Swagger UI默认不会自动识别[FromForm] IFormFile参数对应的文件上传控件，核心是它需要明确知道接口接收的是multipart/form-data类型请求，而默认配置没有为这类参数自动添加对应的请求元数据。

解决办法 #

方法1：给接口添加[Consumes]特性 #

直接在控制器方法上添加[Consumes("multipart/form-data")]特性，明确告知Swagger该接口接收表单数据：

[HttpPost]
[Consumes("multipart/form-data")] // 添加这一行
public IActionResult UploadFile([FromForm] IFormFile file)
{
    return Ok();
}

重启应用后，Swagger UI就会显示文件上传按钮，和你期望的效果一致。

方法2：全局配置Swagger支持文件上传（可选） #

如果项目中有多个文件上传接口，可以通过配置SwaggerGen的OperationFilter全局处理，避免逐个接口加特性：
在Program.cs的AddSwaggerGen中添加以下配置：

builder.Services.AddSwaggerGen(c =>
{
    c.OperationFilter<FileUploadOperationFilter>();
});

// 定义自定义的OperationFilter
public class FileUploadOperationFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        var formFileParams = context.MethodInfo.GetParameters()
            .Where(p => p.ParameterType == typeof(IFormFile) || 
                        p.ParameterType.IsGenericType && 
                        p.ParameterType.GetGenericTypeDefinition() == typeof(IEnumerable<IFormFile>));

        if (formFileParams.Any())
        {
            operation.RequestBody = new OpenApiRequestBody
            {
                Content = new Dictionary<string, OpenApiMediaType>
                {
                    ["multipart/form-data"] = new OpenApiMediaType
                    {
                        Schema = new OpenApiSchema
                        {
                            Type = "object",
                            Properties = formFileParams.ToDictionary(
                                p => p.Name,
                                p => new OpenApiSchema
                                {
                                    Type = "string",
                                    Format = "binary"
                                }),
                            Required = new HashSet<string>(formFileParams.Select(p => p.Name))
                        }
                    }
                }
            };
        }
    }
}

这种方式会自动为所有包含IFormFile参数的接口添加multipart/form-data请求配置。

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