HttpsURLConnection抛SocketTimeoutException时连接未关闭问题求解

文件检索操作触发连接超时异常时存在连接无法正常关闭的问题，表现为同一文件重复抛出java.net.SocketTimeoutException: connect timed out报错。预期实现逻辑：首次抛出超时异常时直接忽略当前文件，跳过该文件的全量处理流程，继续处理列表中的下一个文件。

• 连接资源创建在try块外，异常分支的关闭逻辑存在致命问题：连接超时发生时，con.getInputStream()本身就会抛出异常，catch块中执行con.getInputStream().close()会直接触发二次异常，后续连接释放逻辑完全无法执行
• 连接释放方式错误：HttpsURLConnection不能仅靠关闭输入流释放底层TCP连接，必须主动调用disconnect()方法才能彻底释放套接字资源
• 缺少超时文件的跳过标记：异常抛出后如果上层存在通用重试逻辑，会对已经超时的文件重复发起请求，导致重复报错

// 外层维护超时文件标记集合，从流程上避免重复处理
Set<String> skippedTimeoutFiles = new HashSet<>();

for (String fileUrl : pendingFileList) {
    // 命中超时标记直接跳过，不发起重复请求
    if (skippedTimeoutFiles.contains(fileUrl)) {
        continue;
    }

    try {
        HttpsURLConnection conn = (HttpsURLConnection) new URL(fileUrl).openConnection();
        try {
            // 基础请求配置
            conn.addRequestProperty("Accept", "app/json");
            conn.addRequestProperty("Authorization", jsonParams);
            // 同时设置连接超时、读超时，覆盖全请求阶段
            conn.setConnectTimeout(timeoutConnection);
            conn.setReadTimeout(timeoutConnection);
            // 禁用连接缓存，避免复用坏连接
            conn.setUseCaches(false);

            int respCode = conn.getResponseCode();
            String responseContent;
            // 区分正常流、错误流读取
            if (respCode >= 200 && respCode < 300) {
                try (InputStream inputStream = conn.getInputStream()) {
                    responseContent = IOUtils.toString(inputStream, StandardCharsets.UTF_8);
                }
            } else {
                try (InputStream errorStream = conn.getErrorStream()) {
                    responseContent = IOUtils.toString(errorStream, StandardCharsets.UTF_8);
                }
            }
            // 正常结果处理逻辑
            handleFileResult(new File(respCode, responseContent));
        } catch (SocketTimeoutException e) {
            System.err.println("文件连接超时，已跳过：" + fileUrl + "，错误：" + e.getMessage());
            // 标记当前文件为超时跳过，后续不再处理
            skippedTimeoutFiles.add(fileUrl);
        } finally {
            // 兜底主动断开连接，彻底释放底层资源
            conn.disconnect();
        }
    } catch (IOException e) {
        System.err.println("文件处理IO异常：" + fileUrl + "，错误：" + e.getMessage());
    }
}

• 资源释放兜底：在finally块中统一调用conn.disconnect()释放连接，不再依赖输入流close操作，彻底避免超时场景下流对象未初始化导致的关闭失败
• 流程层防重复：维护超时文件集合，首次触发超时即标记，后续遍历直接跳过，从业务逻辑层杜绝同一文件重复发起请求的问题
• 配置补全：同时设置连接超时、读超时参数，禁用连接缓存，覆盖连接建立、数据读取全阶段的超时场景，避免坏连接复用
• 流资源安全管理：所有输入流使用try-with-resources语法托管，由JVM自动完成关闭，不存在流泄漏风险

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