使用OpenAPI连接服务调用带IFormFile的WebAPI报400缺失content-type边界

你遇到的400错误是因为服务端IFormFile类型参数要求请求必须是multipart/form-data格式，而默认OpenAPI连接服务生成的客户端代码，直接将传入的Stream作为二进制请求体发送，没有按表单格式封装，缺少请求头中content-type的boundary标识，导致服务端无法解析表单数据。

以下三种方案按需选择即可：

方案1：修正服务端Swagger配置（最推荐，后续生成客户端无需额外调整） #

1. 首先给上传接口添加[Consumes]特性，显式声明接口接收表单类型请求：

[HttpPost("Transform")]
[Consumes("multipart/form-data")] // 新增这行
public IAsyncEnumerable<WeatherForecast> Create(IFormFile file)
{
    // 原有逻辑保持不变
}

2. 如果重新生成客户端还是只暴露Stream参数，可在服务端Swagger生成配置中添加表单参数识别逻辑，在Program.cs的AddSwaggerGen配置块中加入如下操作过滤器：

builder.Services.AddSwaggerGen(options =>
{
    // 原有其他配置不变
    options.OperationFilter<Swashbuckle.AspNetCore.Annotations.AnnotationsOperationFilter>();
    // 新增IFormFile表单处理逻辑
    options.OperationFilter<FormFileOperationFilter>();
});

// 自定义过滤器实现
public class FormFileOperationFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        var formFileParams = context.MethodInfo.GetParameters()
            .Where(p => p.ParameterType == typeof(IFormFile) || p.ParameterType == typeof(IFormFileCollection));
        if (!formFileParams.Any()) return;

        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 ?? "file", 
                            p => new OpenApiSchema { Type = "string", Format = "binary" })
                    }
                }
            }
        };
    }
}

3. 重新运行服务端，重新生成OpenAPI客户端，此时生成的方法会自动封装表单请求，直接调用即可正常上传文件。

方案2：直接调整接口实现，无需解析表单（适合仅需上传二进制流的场景） #

如果你的场景只需要传递原始数据流，不需要额外表单字段，可以直接从请求体读流，无需用IFormFile：

[HttpPost("Transform")]
[DisableRequestSizeLimit] // 可选，大文件上传时取消大小限制
public IAsyncEnumerable<WeatherForecast> Create()
{
    var requestStream = Request.Body;
    // 直接处理requestStream即可
    async IAsyncEnumerable<WeatherForecast> answer()
    {
        yield return new WeatherForecast
        {
            Date = DateTime.Now,
            Summary = "",
            TemperatureC = 1
        };
    }
    return answer();
}

这种方案下你原有客户端的Stream调用代码不需要任何修改，即可正常运行。

方案3：手动修改自动生成的客户端代码（临时应急用，不推荐） #

如果不方便调整服务端代码，可以手动修改生成的swaggerClient.cs中TransformAsync方法的请求构造逻辑，将Stream包装为表单内容：
找到方法中构造请求的部分，将直接赋值Content的逻辑替换为：

var formContent = new MultipartFormDataContent();
formContent.Add(new StreamContent(file), "file", "upload.file");
request.Content = formContent;

注意：该方案的修改会在每次重新生成客户端时被覆盖，仅适合临时调试使用。

内容的提问来源于stack exchange，提问作者MrD at KookerellaLtd