Java写入Google Calendar触发java.net.SocketTimeoutException求助

从你的描述和代码来看，读取功能正常但写入1-2条后就超时，说明核心网络连通性没问题，问题大概率出在写入请求的客户端配置、重试逻辑或者API配额/网络限制上。下面一步步帮你分析和解决：

1. 先调整HTTP客户端的超时时间 #

Google API客户端默认的读取超时可能偏短，写入事件涉及数据提交和Google端的处理，耗时比读取更长。你需要在构建Calendar服务实例时，显式设置更长的连接和读取超时：

// 构建HttpTransport时配置超时
HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
HttpRequestInitializer customInitializer = new HttpRequestInitializer() {
    @Override
    public void initialize(HttpRequest request) throws IOException {
        // 设置30秒连接超时，60秒读取超时（可根据实际情况调整）
        request.setConnectTimeout(30000);
        request.setReadTimeout(60000);
        // 如果原本有其他初始化逻辑（比如凭据），记得保留
        credential.initialize(request);
    }
};

// 用自定义的Initializer构建Calendar服务
Calendar service = new Calendar.Builder(httpTransport, JSON_FACTORY, credential)
        .setHttpRequestInitializer(customInitializer)
        .setApplicationName("你的应用名称")
        .build();

这一步能直接解决因默认超时过短导致的写入失败。

2. 优化重试逻辑，加入幂等性保障 #

你现在的嵌套try-catch重试不仅不优雅，还存在重复创建事件的风险——如果Google已经处理了请求但响应超时，重试会生成重复的日程。建议改成循环重试，并利用Google API的requestId参数实现幂等：

int maxRetries = 4;
int retryCount = 0;
boolean isSuccess = false;
// 定义重试间隔，递增设置更合理
long[] retryDelays = {1000, 5000, 10000, 20000};

while (!isSuccess && retryCount < maxRetries) {
    try {
        evento = service.events().insert(idCalendario, evento)
                .setSendUpdates("none")
                // 生成唯一的requestId，确保重复请求不会创建重复事件
                .setRequestId(UUID.randomUUID().toString())
                .execute();
        isSuccess = true;
        logger.info("事件写入成功，ID：{}", evento.getId());
    } catch (SocketTimeoutException e) {
        retryCount++;
        logger.warn("SocketTimeoutException，第{}次重试", retryCount);
        if (retryCount < maxRetries) {
            try {
                Thread.sleep(retryDelays[retryCount - 1]);
            } catch (InterruptedException ie) {
                // 中断异常处理，恢复线程中断状态
                Thread.currentThread().interrupt();
                logger.error("重试线程被中断", ie);
                break;
            }
        }
    } catch (IOException e) {
        logger.error("写入事件时发生IO异常", e);
        break;
    }
}

if (!isSuccess) {
    logger.error("经过{}次重试后仍无法写入事件", maxRetries);
}

setRequestId是关键：相同的requestId会被Google视为同一个请求，即使重试也不会重复创建事件，避免数据重复。

3. 检查Google Calendar API的配额限制 #

Google对API请求有配额限制（比如每分钟请求数、每日请求数），写入操作的配额可能和读取不同。你可以登录Google Cloud Console，找到你的项目和Calendar API，查看配额使用情况：

• 如果发现配额接近或超出限制，要么调整请求频率（延长重试间隔），要么申请提高配额。

4. 规范时区设置，避免潜在的时间处理延迟 #

你的代码中用了Europe/Rome时区，但创建DateTime时直接传入Date（无时区信息），可能导致Google端做额外的时区转换，间接增加处理时间。建议显式指定时区：

TimeZone romeZone = TimeZone.getTimeZone("Europe/Rome");
// 事件开始时间
evento.setStart(new EventDateTime()
        .setDateTime(new DateTime(startDate, romeZone))
        .setTimeZone("Europe/Rome"));
// 事件结束时间
evento.setEnd(new EventDateTime()
        .setDateTime(new DateTime(endDate, romeZone))
        .setTimeZone("Europe/Rome"));

这是一个规范的实践，能避免因时间歧义导致的不必要处理延迟。

5. 排查网络层面的POST请求限制 #

读取用的是GET请求，写入用的是POST请求，有可能你的网络环境（代理、防火墙）对POST请求有额外的限制或延迟。可以用curl手动测试一个POST请求到Google Calendar API，看是否能正常响应：

# 替换成你的access_token、日历ID和事件数据
curl -X POST "https://www.googleapis.com/calendar/v3/calendars/{你的日历ID}/events" \
-H "Authorization: Bearer {你的access_token}" \
-H "Content-Type: application/json" \
-d '{
  "start": {"dateTime": "2024-05-20T09:00:00+02:00", "timeZone": "Europe/Rome"},
  "end": {"dateTime": "2024-05-20T10:00:00+02:00", "timeZone": "Europe/Rome"},
  "summary": "测试事件"
}'

如果curl也超时，那就是网络环境的问题，需要联系运维团队调整防火墙/代理规则。

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