嘿，这个问题我之前也碰到过——Postman跑起来没问题，Swagger一调用就400，多半是Swagger和Spring对路径、参数类型的处理细节没对上，咱们来一步步搞定它：

1. 先搞定路径尾部的斜杠问题 #

你的Controller里写的是/{clientId}/（尾部带斜杠），但Swagger在生成请求的时候，可能会因为这个斜杠导致路径匹配失败。比如你在Swagger里输入clientId后，实际请求的路径可能是/xxxx（没带尾部斜杠），而Spring的路径匹配虽然宽松，但有时候这种细微差异还是会触发400。

改法很简单：把RequestMapping的路径改成不带尾部斜杠的形式，同时明确指定请求方法为GET（避免Swagger乱发请求类型）：

@GetMapping("/{clientId}")
public ResponseEntity<ClientDto> getClientById(
    @ApiParam(name = "Client Id", required = true) 
    @PathVariable("clientId") UUID clientId) {
    // 你的业务逻辑代码
}

用@GetMapping替代@RequestMapping更清晰，Spring也会自动兼容有无尾部斜杠的请求，不会再因为这个卡壳。

2. 让Swagger正确识别UUID参数 #

Swagger有时候对UUID这种特殊类型的参数支持不够聪明，可能会把它当成普通字符串处理，导致传递的参数格式不符合UUID规范（比如少了连字符，或者格式不对），后端解析失败就返回400。

解决办法：给@ApiParam加个example，明确告诉Swagger该传什么样的UUID：

@ApiParam(name = "Client Id", required = true, example = "550e8400-e29b-41d4-a716-446655440000")
@PathVariable("clientId") UUID clientId

这样Swagger会自动填充示例值，用户调用的时候也能照着格式输入，避免参数格式错误。另外，如果你用的是比较老的springfox-swagger版本（比如2.8.x及以下），建议升级到2.9.2以上，旧版本确实有UUID参数的兼容问题。

3. 检查Swagger的请求头设置 #

虽然Postman正常，但Swagger可能默认给请求加了不必要的Content-Type头（比如application/json），而你的接口是GET请求，根本不需要请求体，这种多余的头信息可能会被后端判定为无效请求，返回400。

解决办法：

• 用@GetMapping注解后，Swagger会自动识别这是GET请求，不会乱加请求体相关的头；
• 如果还是有问题，在Swagger的请求页面里手动删除Content-Type之类的多余请求头，只保留你需要的（比如Authorization如果有的话）。

4. 调试实际请求内容（终极排查） #

如果上面的方法都没用，那就开启Spring的请求日志，看看Swagger实际发出去的请求到底是什么样的，和Postman的请求对比差异：
在你的application.properties（或application.yml）里加这段配置：

logging.level.org.springframework.web=DEBUG
logging.level.org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping=DEBUG

日志里会显示请求的完整路径、参数、头信息，对比Postman的请求，就能一眼看出哪里不一样了——比如参数是不是没传对，或者路径多了/少了字符。

我之前就是因为路径尾部斜杠和Swagger的UUID参数格式问题踩过坑，调整后就正常了，你按上面的步骤试一下，应该能解决问题。

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