SpringBoot通过API网关调用含Thread.sleep的接口时出现405错误

核心原因：断路器触发fallback后路径方法不匹配 #

1. 断路器超时触发fallback：你配置的CircuitBreaker（默认是Resilience4j）超时阈值通常小于5秒（比如默认1秒），当服务接口因Thread.sleep(5000)延迟响应时，断路器会判定服务不可用，立即触发fallback逻辑，将请求转发到/fallback/userServiceFallback。
2. fallback路径无对应GET接口：网关中未编写匹配/fallback/userServiceFallback的GET请求处理器，导致网关返回405 Method Not Allowed错误。
3. 原请求已转发至服务：断路器触发fallback不影响已发送到服务的请求，因此5秒后服务控制器的断点仍会被命中。

解决方案 #

1. 调整断路器超时时间 #

修改网关配置，将断路器的超时时间设置为大于模拟延迟的数值（比如6秒），避免误触发fallback：

resilience4j:
  timelimiter:
    instances:
      userServiceCircuitBreaker:
        timeout-duration: 6s

2. 完善fallback接口 #

在网关中添加支持GET方法的fallback处理器，确保触发fallback时返回合法响应：

@RestController
@RequestMapping("/fallback")
public class FallbackController {

    @GetMapping("/userServiceFallback")
    public ResponseEntity<List<User>> userServiceFallback() {
        return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE)
                             .body(Collections.emptyList());
    }
}

3. 规范模拟延迟的方式 #

在Spring MVC中使用Thread.sleep会阻塞线程池，生产环境建议避免。如果需要模拟延迟，可改用异步方式：

@RequestMapping(value = "/users", method = RequestMethod.GET)
public CompletableFuture<List<User>> getAllUsers() {
    return CompletableFuture.supplyAsync(() -> {
        try {
            Thread.sleep(5000);
        } catch (InterruptedException e) {
            throw new RuntimeException(e);
        }
        System.out.println("In getAllUsers");
        return userService.findAllUsers();
    });
}

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