如何在.NET Core 2.2 中使用Swagger添加自定义请求头以包含请求标识？

在.NET Core 2.2中，你可以使用Swashbuckle.AspNetCore库来集成Swagger，并通过配置来添加自定义请求头。以下是一些步骤：

1. 首先，在你的项目中安装Swashbuckle.AspNetCore NuGet包：

   dotnet add package Swashbuckle.AspNetCore

2. 在Startup.cs文件中添加Swagger服务注册：

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddSwaggerGen(c =>
       {
           // 其他配置...
           c.OperationFilter<AddCustomHeaderToRequests>();
       });
       // ...其他服务注册
   }

3. 创建一个自定义操作过滤器`AddCustomHeaderToRequests`：

   using Microsoft.OpenApi.Models;
   using System.Linq;

   public class AddCustomHeaderToRequests : IOperationFilter
   {
       public void Apply(OpenApiOperation operation, OperationFilterContext context)
       {
           if (operation.Produces.Any(p => p.MediaType == "application/json"))
           {
               var securityRequirements = operation.Security?.FirstOrDefault()?.Requirements ?? Enumerable.Empty<string>();

               foreach (var requirement in securityRequirements)
               {
                   var headerDefinition = new HeaderDefinition()
                   {
                       Description = "Request Identifier",
                       Required = true,
                       Name = "X-Request-ID", // 自定义请求头名称
                       Schema = new StringSchema() { Format = "string" },
                   };

                   operation.RequestBody?.Headers.Add(headerDefinition);
               }
           }
       }
   }

4. 确保`ConfigureServices`和`Configure`方法都已启用Swagger服务：

   public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
   {
       app.UseSwagger();
       app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "API v1"));
       // ...其他中间件配置
   }

现在，每次发起HTTP请求时，都会自动包含名为`X-Request-ID`的自定义请求头。