Springfox为Swagger UI添加Cookie参数文档的请求异常问题

我明白你遇到的困扰了——用curl带Cookie能正常请求，但Swagger UI点击Execute后就是发不出Cookie，返回400错误。这其实是因为你把@ApiImplicitParam绑定到了HttpHeaders参数上，Swagger UI没法自动把你输入的Cookie值映射到HttpHeaders对象里的请求头中。下面给你两个可行的解决方案：

方案1：用@CookieValue单独接收Cookie参数 #

这是最直接的方式，Swagger能完美识别并生成对应的输入框，发送请求时也会自动带上Cookie：

@GetMapping(value = "cookies")
@ApiImplicitParam(name = "KEY", paramType = "cookie", type = "string", example = "VALUE")
public void methodA(@CookieValue("KEY") String cookieValue, HttpHeaders headers) {
    // 你可以直接使用cookieValue，或者继续用headers处理其他请求头
    service.checkCookie(headers);
}

这样配置后，Swagger UI会显示一个KEY的Cookie输入框，你输入值点击Execute，请求就会带上Cookie: KEY=你输入的值，和curl的效果一致，后端就能正常校验通过了。

方案2：单独接收Cookie请求头（适配必须用HttpHeaders的场景） #

如果你的业务逻辑必须依赖HttpHeaders对象，那可以单独接收Cookie请求头字符串，再手动添加到HttpHeaders中：

@GetMapping(value = "cookies")
@ApiImplicitParam(name = "Cookie", paramType = "header", type = "string", example = "KEY=VALUE")
public void methodA(@RequestHeader("Cookie") String cookieHeader, HttpHeaders headers) {
    // 将手动接收的Cookie头添加到HttpHeaders中（如果需要的话）
    headers.add("Cookie", cookieHeader);
    service.checkCookie(headers);
}

这种方式下，Swagger UI会生成一个Cookie请求头的输入框，你输入KEY=VALUE后，请求就会带上正确的Cookie头，和curl命令的逻辑完全匹配。

为什么之前的配置无效？ #

当你把@ApiImplicitParam标注在HttpHeaders参数上时，Swagger UI无法将你输入的单个"cookie"值自动注入到HttpHeaders这个集合对象里——它不知道该把这个值放到哪个请求头字段中。所以点击Execute时，请求实际上没有携带Cookie头，导致后端校验失败返回400。而curl是你手动指定了Cookie头，所以能正常工作。

内容的提问来源于stack exchange，提问作者albertoiNET