java 11 httpclient 最简异步请求需三步：httpclient.newbuilder() 构建客户端，httprequest.newbuilder() 构建带超时和头的请求，再调用 sendasync() 并配对 thenaccept 与 exceptionally；主线程须等待，否则请求可能丢失。
Java 11 HttpClient 怎么发一个最简异步请求
直接用 HttpClient.newBuilder() + HttpRequest.newBuilder() + sendAsync()，三步到位。同步调用是 send()，异步必须显式调用 sendAsync()，否则还是阻塞的——这是新手最常卡住的地方。
常见错误现象：CompletableFuture 一直不触发回调，或者主线程退出后请求悄无声息失败（没加 join() 或 get() 等待）。
-
HttpClient默认使用内置的ForkJoinPool.commonPool()执行异步任务，别指望它自动“守护”你的主线程 - 如果请求体是 JSON，记得手动设
header("Content-Type", "application/json")，HttpClient不会自动推断 - 超时必须显式配置：在
HttpRequest上用timeout(Duration.ofSeconds(5))，否则默认无限等待
HttpClient client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(3))
.build();
HttpRequest request = HttpRequest.newBuilder(URI.create("https://httpbin.org/get"))
.timeout(Duration.ofSeconds(5))
.GET()
.build();
client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
.thenAccept(resp -> System.out.println(resp.body()))
.exceptionally(t -> { System.err.println(t); return null; });
为什么 sendAsync() 返回的 CompletableFuture 有时不执行 thenAccept
根本原因就两个：线程提前结束，或异常被吞掉。Java 11 的 HttpClient 异步路径里，任何底层 I/O 异常（比如 DNS 失败、连接拒绝）都会包装成 CompletionException 抛给 CompletableFuture，但如果你只写 thenAccept，它不会捕获异常分支。
- 务必配对使用
thenAccept+exceptionally，或者统一用whenComplete - 如果主线程是 main 方法，跑完就 exit，异步任务可能根本没机会调度——加个
Thread.sleep(2000)或用countDownLatch.await()等待不是权宜之计，而是必要步骤 - 不要复用同一个
HttpClient实例却反复修改其connectTimeout：它是 builder 构建时快照的，实例创建后不可变
BodyHandler.ofString() 和 ofByteArray() 的实际区别在哪
不只是返回类型不同，关键在内存行为和编码处理逻辑。ofString() 默认用 UTF-8 解码，且要求响应体可完整载入内存；ofByteArray() 不做解码，原样返回字节，适合二进制或需要自定义字符集的场景。
立即学习“Java免费学习笔记（深入）”；
- 响应体超大（比如 50MB 文件）时，
ofString()会 OOM，必须换ofInputStream()流式处理 - 如果服务端返回 ISO-8859-1 编码但没声明 charset，
ofString()会错解成 UTF-8，结果乱码——这时得用ofByteArray()+ 手动new String(bytes, StandardCharsets.ISO_8859_1) -
ofString()内部调用了String::new(byte[])，本质就是 new String(bytes)，没有额外容错
如何安全复用 HttpClient 实例并避免连接泄漏
HttpClient 是线程安全的，设计上就该复用；但如果不小心关了它，或漏了响应体消费，连接池里的 socket 可能卡在 CLOSE_WAIT 状态，最终耗尽。
- 永远不要调用
httpClient.close()—— 它不是 Closeable，强行 cast 关闭会抛UnsupportedOperationException - 即使异步失败，也要确保
HttpResponse.BodyHandler被触发（哪怕只是丢弃），否则连接不会归还到池中 - 用
HttpResponse.BodyHandlers.ofFile(Paths.get("out.txt"))时，如果目标目录不存在，会抛IOException并导致连接泄露，务必提前检查路径 - 连接池默认最大 20 个空闲连接，超时 20 秒，可通过
HttpClient.Builder::pool自定义，但多数场景保持默认即可
异步 HTTP 最容易被忽略的，其实是响应体是否真正被读取——无论成功失败，只要没触达 BodyHandler，连接就悬着。这点不像 OkHttp 或 Retrofit 那样有隐式兜底。
