Spring Boot RestTemplate调用API时HttpClient Cookie过期时间解析警告问题

一、可用的预定义Cookie规范 #

在Apache HttpClient 4.5.x（你使用的是4.5.13）中，预定义的RFC_6265规范可直接兼容RFC1123格式的Cookie过期日期，无需自定义解析逻辑。该规范贴合现代Cookie标准，能正确解析Sat, 21 Feb 2026 14:43:55 GMT这类格式的expires属性。

二、Spring Boot中配置使用RFC_6265规范的RestTemplate #

通过自定义RestTemplate的底层HttpClient实例，指定使用RFC_6265 Cookie规范即可解决问题，具体配置代码如下：

import org.apache.http.client.config.CookieSpecs;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;

@Configuration
public class RestTemplateConfig {

    @Bean
    public RestTemplate restTemplate() {
        // 创建请求配置，指定Cookie规范为RFC_6265
        RequestConfig requestConfig = RequestConfig.custom()
                .setCookieSpec(CookieSpecs.RFC_6265)
                .build();

        // 构建HttpClient并应用配置
        CloseableHttpClient httpClient = HttpClients.custom()
                .setDefaultRequestConfig(requestConfig)
                .build();

        // 配置RestTemplate使用自定义HttpClient
        HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory(httpClient);
        return new RestTemplate(factory);
    }
}

三、默认配置不兼容的原因 #

Apache HttpClient 4.5.x的默认Cookie规范是DefaultCookieSpec，这是一个兼容模式规范，优先遵循老旧的Netscape Cookie草案格式（对应NetscapeDraftSpec.EXPIRES_PATTERN：EEE, dd-MMM-yy HH:mm:ss z）。该格式要求年份为两位（yy），而API返回的RFC1123格式使用四位年份（yyyy），导致解析失败并触发警告。

而RFC_6265规范是为适配现代Web标准设计的，支持RFC1123定义的完整日期格式，因此可以完美解析这类Cookie。

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