也许我的答案能帮到一些人。
正如在his answer中提到的Dilip Krishnan，您可以使用io.swagger.annotations.ApiParam或io.swagger.annotations.ApiImplicitParam Swagger注解对自定义文档进行微调。
@ApiParam可用于已注册的方法参数。
如果API参数未显式注册，则可以使用@ApiImplicitParam。

@RestController
@RequestMapping(value = "/v1/test", produces = "application/json")
@Api(value = "/v1/test")
public class TestController {

    @ApiOperation(value = "Do Something method", tags = "Test method")
    @RequestMapping(value = "/doSomeThing", method = RequestMethod.GET)
    public Foo doSomeThing(
            @ApiParam(value = "Param1 Description", required = true)
            @RequestParam String param) {
        throw new UnsupportedOperationException("do Some Things");
    }

    @ApiOperation(value = "Do Something Another method", tags = "Test method")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "anotherParam1", value = "Another Param1 Description", paramType = "header"),
            @ApiImplicitParam(name = "anotherParam1", value = "Another Param1 Description", paramType = "header")
    })
    @RequestMapping(value = "/doSomeThingAnother", method = RequestMethod.GET)
    public Foo doSomeThingAnother(Bar bar) {
        throw new UnsupportedOperationException("do Some Thing Another");
    }
}

最后你可以看到下面这张图

TL;DR是你必须建立你自己的插件来做这件事。
基本上，在这种情况下，唯一能够增强描述的现成注解是@ApiParam，更准确地说是@ApiImplicitParam。
因此，我的建议是：
1.创建您自己的注记，如下所示
@RequestHeader(name = "Api-Key") @Description("Value of license key") String apiKey
注意：已经有一个annotation in spring适用于此。
1.创建您自己的ParameterBuilderPlugin
1.如下所示实现插件

public class Test implements ParameterBuilderPlugin {
  @Override
  public void apply(ParameterContext parameterContext) {
    ResolvedMethodParameter methodParameter =parameterContext.resolvedMethodParameter();
    Optional<Description> requestParam = methodParameter.findAnnotation(Description.class);
    if (requestParam.isPresent()) {
      parameterContext.parameterBuilder()
        .description(requestParam.get().value());
    }
  }

  @Override
  public boolean supports(DocumentationType documentationType) {
    return false;
  }
}

1.拾取在处理了Swagger标注之后应用的顺序值。
另外，请将您的springfox库升级到latest version。

我们遇到了同样的问题，并通过以下方式解决了该问题：

.. @RequestHeader(value = "..") @ApiParam(value = "Description") String param ..

这个想法是在生成的swagger中添加“描述”字段。它可能看起来很笨拙，但它是一个快速简单的解决方案，在你的个人情况下可能很有用。

快速、简单有效的解决方案是使用enum，例如：

@RequestHeader(value = "someval") ALLOWED_VALUES input

private enum ALLOWED_VALUES {A, B, C};

下面将显示出昂首阔步：可用值：A, B, C个