虽然这篇文章是旧的，我认为它会帮助新来者，如果他们陷入同样的情况。

public class AddRequiredHeaderParameter : IOperationFilter
{
    public void Apply(Operation operation, SchemaRegistry schemaRegistry,
                      ApiDescription apiDescription)
    {
        if (operation.parameters == null)
        {
            operation.parameters = new List<Parameter>();
        }

       /*System.Diagnostics.Trace.WriteLine(apiDescription.RelativePath +
          "=paath");*/
        if (apiDescription.RelativePath.Contains(***{url***}))
        {
            operation.parameters.Add(new Parameter
            {
                name = "X-User-Token",
                @in = "header",
                type = "string",
                required = false,
                description=""
            });
            operation.parameters.Add(new Parameter
            {
                name = "authorization",
                @in = "header",
                description = "Token",
                type = "string",
                required = true
            });
        }
        else
        {
            operation.parameters.Add(new Parameter
            {
                name = "X-User-Token",
                @in = "header",
                type = "string",
                required = false,
                description="description"
            });
        }
    }
}

在Asp.Net核心/. net 6中

using Microsoft.AspNetCore.Mvc.ApiExplorer;
using Swashbuckle.AspNetCore.SwaggerGen;
using Microsoft.OpenApi.Models;

namespace YourProduct
{
    public class HttpHeaderOperationFilter : IOperationFilter
    {
        public void Apply(OpenApiOperation operation, OperationFilterContext context)
        {

            operation.Parameters.Add(new OpenApiParameter
            {
                Name = "X-your-Custom-header",
                In = ParameterLocation.Header,
                AllowEmptyValue = true,
                Required = false,
                Description = "Your custom header Name"

            });
        }
    }
}

在行动中

[HttpPost("[action]")]
[SwaggerOperationFilter(typeof(HttpHeaderOperationFilter))] //<-- point of interest
public IActionResult DoSomething([FromBody] YourModel model)
{
. . . . . . .

别忘了startup.cs

services.AddSwaggerGen(opt =>
{
    opt.EnableAnnotations(); // <-- this
}