Jenkins删除Artifactory大目录时触发ClosedByInterruptException异常求助

针对你在Jenkins共享库中用ArtifactManager清理Artifactory大型Docker镜像目录（50GB）时出现的ClosedByInterruptException问题，以下是具体的处理和规避方案：

1. 优先使用Artifactory异步删除API #

Artifactory支持异步删除机制，无需等待删除操作完成即可返回请求，从根源上避免Jenkins线程因长时间阻塞被中断。只需在删除请求的URL中添加?async=true参数：

// 示例：构建异步删除请求URL
String deleteUrl = "https://your-artifactory-url/api/docker/repo/v2/path/to/large/directory?async=true";

这种方式下，Artifactory会在后台执行删除任务，Jenkins线程无需持续等待，自然不会触发中断异常。

2. 调整Jenkins线程超时配置 #

如果必须同步等待删除完成，需要调整Jenkins的超时设置，避免线程被主动中断：

• 全局/任务级构建超时：在Jenkins全局配置或目标任务的配置页，延长「构建超时时间」，确保删除操作的耗时在超时范围内。
• Agent连接超时：若任务运行在Jenkins Agent上，检查Agent的连接超时、空闲超时设置，避免Agent因长时间无响应主动断开线程。

3. 优化HTTP客户端超时与异常处理 #

无论使用HttpURLConnection还是HTTPBuilder，都需要明确配置超时并捕获中断类异常，同时添加重试逻辑：

针对HttpURLConnection #

HttpURLConnection conn = (HttpURLConnection) new URL(deleteUrl).openConnection();
conn.setRequestMethod("DELETE");
// 设置合理的连接和读取超时（示例为30分钟）
conn.setConnectTimeout(1800000);
conn.setReadTimeout(1800000);

try {
    int responseCode = conn.getResponseCode();
    // 处理响应逻辑
} catch (ClosedByInterruptException e) {
    // 记录中断日志，触发重试
    log.warn("删除请求被中断，准备重试", e);
    // 恢复线程中断状态，避免影响后续逻辑
    Thread.currentThread().interrupt();
    // 执行重试逻辑（需控制重试次数，避免无限循环）
    retryDelete();
} catch (IOException e) {
    // 处理其他IO异常
} finally {
    conn.disconnect();
}

针对HTTPBuilder #

def http = new HTTPBuilder(deleteUrl)
http.client.getParams().setParameter(HttpConnectionParams.CONNECTION_TIMEOUT, 1800000)
http.client.getParams().setParameter(HttpConnectionParams.SO_TIMEOUT, 1800000)

try {
    http.request(Method.DELETE) { req ->
        // 配置请求头、认证信息等
        response.success = { resp ->
            // 处理成功响应
        }
    }
} catch (ClosedByInterruptException e) {
    log.warn("删除请求被中断，准备重试", e)
    Thread.currentThread().interrupt()
    retryDelete()
}

4. 分批次拆分删除任务 #

将50GB的大型目录拆分为多个小批量的删除请求，比如按镜像标签、子目录分批处理，单次请求处理的资源量减小，耗时缩短，大幅降低被中断的概率。例如：

• 先删除目录下的v1.x系列镜像，再删除v2.x系列，分多次请求完成整体清理。

5. 排查Jenkins与Artifactory端的资源问题 #

• Jenkins端：检查Jenkins系统日志，确认是否是Jenkins因构建超时、资源不足主动中断线程。
• Artifactory端：确认Artifactory服务器的磁盘IO、内存、CPU资源是否充足，避免因Artifactory端处理缓慢导致连接超时关闭。

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