Swagger中POST文件上传接口无法显示上传按钮的问题求助

问题核心原因 #

你的代码存在两个关键问题：

1. 控制器方法的IFormFile参数未标记[FromForm]特性，导致Swagger无法正确识别这是表单上传类型的参数
2. 自定义FileUploadFilter逻辑冗余且不匹配单文件场景：因为IFormFile本身属于FromForm类型，Filter会触发formParameters.Any()判断并提前返回，根本没执行到自定义RequestBody的逻辑；同时Filter里配置的是多文件数组字段files，和你的单文件参数file不对应

修复方案 #

方案1：最简修复（推荐） #

直接给控制器参数添加[FromForm]特性，Swashbuckle原生支持识别该类型并生成上传按钮，无需自定义Filter：

[HttpPost("{groupId:int:min(1)}/validate")]
[ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
[ProducesResponseType(StatusCodes.Status204NoContent)]
[ProducesResponseType(StatusCodes.Status404NotFound)]
[ProducesResponseType(StatusCodes.Status400BadRequest)]
[ProducesResponseType(StatusCodes.Status502BadGateway)]
public async Task<IActionResult> UploadDocument([FromForm] IFormFile file)
{
    // TODO: handle file upload
    return await Task.FromResult(Ok());
}

同时删除Swagger配置中的c.OperationFilter<FileUploadFilter>()，以及自定义的FileUploadFilter类。

方案2：保留Filter的适配修改 #

如果需要保留Filter兼容其他场景，修改Filter逻辑适配单文件上传：

public class FileUploadFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        // 仅处理未被自动识别的单文件上传接口
        var singleFileParam = context.ApiDescription.ParameterDescriptions
            .FirstOrDefault(p => p.ParameterType == typeof(IFormFile) && !p.IsFromForm());

        if (singleFileParam == null || operation.RequestBody != null)
            return;

        if (context.ApiDescription.HttpMethod == HttpMethod.Post.Method)
        {
            var uploadMediaType = new OpenApiMediaType
            {
                Schema = new OpenApiSchema
                {
                    Type = "object",
                    Properties =
                    {
                        ["file"] = new OpenApiSchema
                        {
                            Type = "string",
                            Format = "binary"
                        }
                    },
                    Required = new HashSet<string> { "file" }
                }
            };

            operation.RequestBody = new OpenApiRequestBody
            {
                Content = { ["multipart/form-data"] = uploadMediaType }
            };
        }
    }
}

同时确保控制器参数添加[FromForm]特性，避免Filter被提前拦截。

验证效果 #

重启API项目后，Swagger页面的POST接口会显示multipart/form-data类型的请求体区域，包含文件选择按钮。

内容的提问来源于stack exchange，提问作者Katia S.