Spring OAuth2RestTemplate首次调用API报404后续正常问题求助

这种间歇性的首次请求失败问题确实挺磨人的，既然团队要求先排查LB之外的可能性，咱们可以从Spring OAuth2RestTemplate的客户端机制、配置细节这些方向入手：

1. 检查RestTemplate的连接池配置 #

OAuth2RestTemplate默认使用SimpleClientHttpRequestFactory，这个工厂是每次请求新建HTTP连接的。首次请求时，新建连接的过程可能和LB的会话保持、连接初始化逻辑冲突，导致路由错误。

建议换成带连接池的HttpComponentsClientHttpRequestFactory，复用连接的同时也能控制连接超时：

@Bean
public OAuth2RestTemplate oAuth2RestTemplate(ClientCredentialsResourceDetails details) {
    OAuth2RestTemplate restTemplate = new OAuth2RestTemplate(details);
    
    // 配置带连接池的HTTP工厂
    PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager();
    connectionManager.setMaxTotal(20); // 最大总连接数
    connectionManager.setDefaultMaxPerRoute(10); // 单路由最大连接数
    
    HttpClient httpClient = HttpClients.custom()
            .setConnectionManager(connectionManager)
            .build();
    
    HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory(httpClient);
    factory.setConnectTimeout(5000); // 连接超时
    factory.setReadTimeout(5000); // 读取超时
    
    restTemplate.setRequestFactory(factory);
    return restTemplate;
}

2. 对比首次与后续请求的完整URL #

有时候首次请求失败，可能是RestTemplate的URL拼接、资源配置出了问题（比如少了API前缀、域名拼接错误），后续请求因为上下文缓存或者自动修正才恢复正常。

建议开启Spring RestTemplate的DEBUG日志，查看两次请求的完整URL：

<!-- Logback配置示例 -->
<logger name="org.springframework.web.client.RestTemplate" level="DEBUG"/>

重点对比：LB域名、API路径、参数是否完全一致，确认首次请求的URL是否符合API服务的路由规则。

3. 排查OAuth2上下文的令牌关联逻辑 #

虽然你说同一令牌后续调用成功，但可以确认下首次请求时令牌是否正确携带到请求头：

• OAuth2RestTemplate依赖OAuth2ClientContext缓存令牌，首次获取令牌后，上下文初始化可能存在微小延迟，导致第一次请求的Authorization头未正确设置。
• 可以手动添加BearerTokenInterceptor，强制令牌拦截器生效：

restTemplate.getInterceptors().add(new BearerTokenInterceptor(details, restTemplate.getOAuth2ClientContext()));

4. 验证API服务端的路由缓存逻辑 #

如果LB确实把请求转发到了API实例，那可以排查API服务本身的路由组件：

• 比如使用Spring Cloud Gateway、Zuul等网关时，首次请求可能触发路由规则加载/缓存，未命中时返回404，后续缓存生效后恢复正常。
• 查看API服务的日志，确认首次请求是否到达实例，以及服务端的路由处理日志，判断是路由未匹配还是其他原因。

5. 补充：LB相关的快速验证 #

如果上述排查都没问题，可以做个简单验证：直接绕过LB，请求API实例的IP+端口，看首次调用是否正常。如果正常，那基本可以锁定是LB的会话保持、路由预热或者健康检查配置问题。

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