调用Jira Server Search Rest API遇java.net.SocketTimeoutException超时问题

针对批量获取Jira项目"XYZ"带链接的问题时遇到的SocketTimeoutException超时异常，以下是可落地的解决办法：

1. 降低单次请求的maxResults值 #

当前单次请求1000条数据，对于包含大量关联链接的问题，Jira需要额外查询关联数据并构建响应，耗时会显著增加。建议将maxResults从1000调整为200-500，减少单次请求的数据量，降低Jira服务器的处理压力，同时缩短客户端等待响应的时间。

修改后的请求示例：

{Jira_Instance_URL}/rest/api/2/search?jql=project=XYZ AND issueFunction in hasLinks()&fields=issuelinks&startAt={当前偏移量}&maxResults=500

2. 调整客户端读取超时配置 #

如果使用Java的RestTemplate或HttpClient发起请求，默认的读取超时时间通常较短（比如30秒），不足以处理大数量级的请求。需要手动增大超时时间，比如设置为5分钟（300000毫秒）。

RestTemplate配置示例： #

SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
factory.setReadTimeout(300000); // 5分钟读取超时
factory.setConnectTimeout(5000); // 连接超时保持5秒即可
RestTemplate restTemplate = new RestTemplate(factory);

HttpClient配置示例： #

RequestConfig requestConfig = RequestConfig.custom()
        .setSocketTimeout(300000)
        .setConnectTimeout(5000)
        .build();
CloseableHttpClient client = HttpClientBuilder.create()
        .setDefaultRequestConfig(requestConfig)
        .build();

3. 优化JQL查询逻辑 #

issueFunction in hasLinks()属于JQL扩展函数，性能不如原生JQL条件。可以尝试拆分查询范围，比如按问题创建时间分段查询，减少单次JQL需要扫描的数据量：

project=XYZ AND issueFunction in hasLinks() AND created >= "2020-01-01" AND created < "2021-01-01"

通过多次请求覆盖不同时间范围，避免一次性扫描全量3万条问题。

另外，确保fields参数只保留issuelinks，不要返回冗余字段，减少响应体大小。

4. 实现超时重试机制 #

针对偶发的超时异常，添加指数退避重试逻辑，避免单次超时导致整个任务中断。比如捕获SocketTimeoutException后，等待5秒、10秒、20秒后重试，最多重试3次。

示例代码片段：

int retryCount = 0;
int maxRetries = 3;
long[] retryDelays = {5000, 10000, 20000}; // 5s, 10s, 20s

while (retryCount <= maxRetries) {
    try {
        // 发起Jira API请求的代码
        break;
    } catch (SocketTimeoutException e) {
        if (retryCount == maxRetries) {
            throw e; // 超过重试次数，抛出异常
        }
        Thread.sleep(retryDelays[retryCount]);
        retryCount++;
    }
}

5. 排查Jira服务器性能问题 #

如果以上方法仍无法解决，需要检查Jira服务器的状态：

• 查看Jira应用日志（atlassian-jira.log），是否存在数据库查询慢、内存不足或线程池耗尽的情况
• 监控服务器CPU、内存、磁盘IO使用率，确认是否存在资源瓶颈
• 检查Jira数据库的索引是否正常，尤其是issue、issuelink表的索引，必要时重建索引

内容的提问来源于stack exchange，提问作者Preethi H R