swagger3怎么在接口上添加请求头

在使用Swagger 3.x（也称为Springfox 3.x）时，要在接口上添加请求头，你需要在API注解或者全局配置中进行设置。这里是一个基本的步骤：

1. **使用@ApiOperation注解**：
对于单个API方法，你可以直接在注解中添加`consumes`和`produces`属性来指定请求内容类型（如JSON），同时使用`@ApiParam`来添加请求头。例如：

   @ApiOperation(value = "Add custom header", consumes = MediaType.APPLICATION_JSON_VALUE, produces = MediaType.APPLICATION_JSON_VALUE)
   @GetMapping("/api")
   public ResponseEntity<String> yourMethod(@ApiParam(name = "Authorization", value = "Your custom authentication header", required = true) @RequestHeader("Authorization") String authorization) {
       // Your method logic
   }

2. **使用@ApiOperation注解的全局配置**：
如果你想在整个项目的多个API上共享相同的请求头，可以在全局配置中设置：

   @EnableSwagger2WebMvc
   @Configuration
   public class SwaggerConfig {

       @Bean
       public Docket createRestApi() {
           return new Docket(DocumentationType.OAS_30)
               .select()
               // 匹配所有API
               .apis(RequestHandlerSelectors.basePackage("your.package.name"))
               .paths(PathSelectors.any())
               // 添加全局请求头
               .globalOperationParameters(Arrays.asList(
                   new ParameterBuilder()
                       .name("Authorization")
                       .description("Your custom authentication header")
                       .required(true)
                       .paramType(ParameterType.HEADER)
                       .build()
               ))
               .build();
       }
   }

这里设置了全局的`Authorization`请求头，如果每个方法都需要这个头，就不必在每个方法上都标注了。

3. **使用RequestBodyAdvice或ResponseBodyAdvice**：
可以编写一个`RequestBodyAdvice`或`ResponseBodyAdvice`来动态地添加请求头。然而这通常是在处理请求体而非请求头的时候使用。