HttpRetryException是JDK内部自动重试失败时抛出的异常，并非用户主动触发；它多见于GET请求，本质是HttpURLConnection对5xx或I/O异常有限重试后仍失败的包装，推荐禁用默认重试或改用HttpClient/OkHttp等可控客户端。
HttpRetryException 是 Java 中 HttpURLConnection 在自动重试失败时抛出的异常，**本质不是你主动触发的重试逻辑报错，而是 JDK 内部尝试重发请求（比如遇到网络闪断、连接被重置）但依然失败后包装的异常**。它通常出现在 GET 请求中，且默认只对部分 5xx 响应或 I/O 异常做有限重试——而这个机制不可控、不透明、也不推荐依赖。
关闭 JDK 默认重试行为（最常用）
JDK 的 HttpURLConnection 在某些条件下（如响应未读完就断开）会自动重试一次 GET 请求，若重试仍失败，就包装成 HttpRetryException 抛出。你可以通过系统属性禁用它：
- 在程序启动前（如
main方法开头）添加：
System.setProperty("sun.net.http.retryPost", "false");（影响 POST，虽不直接相关但建议一并关掉） - 更关键的是：
System.setProperty("http.keepAlive", "false"); 或
System.setProperty("http.maxConnections", "0");
可削弱连接复用带来的重试倾向；但最稳妥的是——别用HttpURLConnection自动重试，自己控制。
改用可控的 HTTP 客户端（推荐方案）
HttpURLConnection 重试机制僵硬、难调试、不支持自定义策略。换成主流客户端可彻底规避该异常：
-
Apache HttpClient：通过
HttpRequestRetryHandler精确控制哪些异常/状态码重试、重试次数、退避时间。 -
OkHttp：内置
RetryAndFollowUpInterceptor，默认对连接异常、超时等重试（1 次），也可自定义Interceptor完全接管。 -
Spring RestTemplate / WebClient：配合
RetryTemplate（Spring Retry）或 Resilience4j 实现声明式重试，逻辑清晰、可观测性强。
捕获并正确处理 HttpRetryException（临时兜底）
如果暂时无法替换底层 HTTP 客户端，需捕获该异常并降级处理：
立即学习“Java免费学习笔记（深入）”；
- 它继承自
IOException，所以可统一捕获IOException；但若需单独识别，可用：
if (e instanceof HttpRetryException) - 获取原始响应码：
((HttpRetryException) e).responseCode()（注意可能为 -1，表示无有效响应） - 不要简单重 throw，应记录日志 + 返回默认值 / 调用备用接口 / 触发告警。
检查是否误用 GET 执行非幂等操作
HttpRetryException 多见于 GET，因为 JDK 默认只对 GET 自动重试。如果你用 GET 提交数据（如带 body 的查询），一旦服务端因重试导致重复处理，可能引发脏数据——这本身是设计错误。
- 确保 GET 纯用于查询，参数走 URL；写操作用 POST/PUT/DELETE。
- 服务端对 GET 请求避免副作用（如修改数据库），否则重试会让问题更隐蔽。
