Spring Boot微服务调用外部API无响应问题处理咨询

1. 先给RestTemplate补上超时配置 #

没超时配置的话，请求会一直挂着，不会抛出任何异常，重试机制根本触发不了——这是当前最核心的问题：

• 分两类超时配置：连接超时（控制建立TCP连接的最长等待时间，比如设5秒，避免卡在连接环节）、读取超时（等待外部服务响应的最长时间，根据对方正常响应速度设置，比如10秒）
• 简单配置示例（用SimpleClientHttpRequestFactory）：

@Bean
public RestTemplate restTemplate() {
    SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
    factory.setConnectTimeout(5000); // 连接超时5秒
    factory.setReadTimeout(10000);   // 读取超时10秒
    return new RestTemplate(factory);
}

如果需要连接池等更灵活的配置，用HttpClient实现：

@Bean
public RestTemplate restTemplate() {
    CloseableHttpClient httpClient = HttpClientBuilder.create()
            .setDefaultRequestConfig(RequestConfig.custom()
                    .setConnectTimeout(5000)
                    .setSocketTimeout(10000)
                    .setConnectionRequestTimeout(5000) // 从连接池获取连接的超时
                    .build())
            .build();
    HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory(httpClient);
    return new RestTemplate(factory);
}

2. 调整重试机制的触发条件 #

原来的重试只监听常规异常，现在要确保超时异常能被捕获并触发重试：

• 使用@Retryable时，把SocketTimeoutException、ConnectTimeoutException这类超时异常，以及RestClientException这类通用客户端异常加入触发列表
• 示例代码：

@Retryable(value = {SocketTimeoutException.class, ConnectTimeoutException.class, RestClientException.class},
           maxAttempts = 3, // 最多重试3次
           backoff = @Backoff(delay = 1000)) // 每次重试间隔1秒
public String callExternalService(String param) {
    return restTemplate.getForObject("https://external-service.com/api", String.class, param);
}

⚠️ 重要提醒：只有当外部服务是幂等接口（比如查询、更新操作）时才能重试；如果是创建类的非幂等接口（比如下单），重试会导致重复数据，必须先确认对方接口的幂等性再开启重试

3. 补全请求链路日志，定位问题更清晰 #

现在只记录请求发出，完全不清楚后续状态，加个拦截器把关键节点都打日志：

• 自定义拦截器记录请求ID、参数、耗时、异常信息：

public class RequestLoggingInterceptor implements ClientHttpRequestInterceptor {
    private static final Logger logger = LoggerFactory.getLogger(RequestLoggingInterceptor.class);

    @Override
    public ClientHttpResponse intercept(HttpRequest request, byte[] body, ClientHttpRequestExecution execution) throws IOException {
        String requestId = UUID.randomUUID().toString();
        logger.info("Req [{}] | URL: {} | Params: {}", requestId, request.getURI(), new String(body, StandardCharsets.UTF_8));
        long startTime = System.currentTimeMillis();
        try {
            ClientHttpResponse response = execution.execute(request, body);
            long cost = System.currentTimeMillis() - startTime;
            logger.info("Req [{}] | Status: {} | Cost: {}ms", requestId, response.getStatusCode(), cost);
            return response;
        } catch (IOException e) {
            long cost = System.currentTimeMillis() - startTime;
            logger.error("Req [{}] | Failed after {}ms | Error: {}", requestId, cost, e.getMessage(), e);
            throw e;
        }
    }
}

将拦截器添加到RestTemplate：

restTemplate.getInterceptors().add(new RequestLoggingInterceptor());

这样就算超时，也能从日志里定位到具体请求ID的异常情况，方便排查是偶发问题还是特定请求导致的

4. 给请求加幂等性保障（如果需要重试） #

如果外部服务是非幂等接口，重试会导致重复操作，需要做防护：

• 给每个请求生成唯一requestId，传递给外部服务，让对方根据这个ID判断是否已经处理过
• 本地数据库记录requestId和请求状态，避免重复发起相同请求

5. 增加监控告警，提前发现问题 #

• 用Spring Boot Actuator或Micrometer监控RestTemplate的请求耗时、超时率、重试次数
• 设置告警阈值，比如超时率超过5%就触发告警，避免问题扩大后才发现

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