java项目连不上elasticsearch主因是版本与协议不匹配：8.x需用elasticsearch-java sdk并启用https认证，7.x用resthighlevelclient，6.x仅兼容transportclient；须核对es版本、开放network.host、配置安全凭证、设置超时及single-node模式。
Java 项目里直接连不上 Elasticsearch，八成不是代码写错了，而是环境没对齐——特别是版本和传输协议。
确认 Elasticsearch 版本与 Java 客户端是否匹配
Elasticsearch 8.x 默认启用 HTTPS + 基础认证，且彻底移除了 Transport Client；7.x 虽支持 RestHighLevelClient，但部分 API 行为和返回结构已不同；6.x 还能用 TransportClient（已废弃），但和 7+ 不兼容。
- 用
curl http://localhost:9200查看实际运行的 ES 版本和version.number - Java 项目里选客户端：ES 7.17 用
elasticsearch-rest-high-level-client:7.17.21；ES 8.12 必须用elasticsearch-java:8.12.2+jakarta.json-api - Maven 里同时引两个大版本客户端会触发
NoClassDefFoundError或IllegalArgumentException: unknown setting
RestHighLevelClient 初始化时必设的参数
ES 7.10+ 默认关闭 http.enabled？不，它默认开，但默认绑定 127.0.0.1，本地 Java 连不上常因这个地址没改。
- 启动 ES 时加配置：
network.host: 0.0.0.0（开发可接受），并确认http.port: 9200 - Java 端初始化要显式设超时：
RequestOptions.DEFAULT.toBuilder().setConnectTimeout(TimeValue.timeValueSeconds(5)) - 别漏掉
setSocketTimeout和setConnectionRequestTimeout，否则 bulk 写入卡住时线程会一直 hang - 如果 ES 开了安全模块（xpack security），
BasicCredentials必须传进HttpAsyncResponseConsumerFactory对应位置，否则报401 Unauthorized
ES 8.x 的 Java SDK 不再有 RestHighLevelClient
官方把客户端彻底重写了，RestHighLevelClient 在 8.x 中已删除，强行用 7.x 客户端连 8.x 服务会抛 UnsupportedOperationException: This operation is not supported for the current client 或直接反序列化失败。
立即学习“Java免费学习笔记（深入）”；
- 换用新 SDK：
co.elastic.clients:elasticsearch-java:8.12.2+co.elastic.clients:elasticsearch-java-jackson:8.12.2 - 连接方式变成构建
EsClient，底层用HttpClientConfig，不再基于 Apache HTTP Components - 索引操作从
client.index(req)变成client.index(i -> i.index("logs").document(doc))，DSL 是 builder 链式调用，不能混用旧 JSON 字符串 - 注意：新 SDK 默认要求 JDK 17+，JDK 11 下跑会提示
java.lang.NoSuchMethodError: java.time.format.DateTimeFormatter.parseBest
最常被跳过的其实是 ES 的 discovery.type=single-node 配置——不加的话，新版本启动后会等集群发现，卡在 “waiting for elected master”，Java 客户端连过去就超时。这个点不在代码里，但在 config/elasticsearch.yml 里，一删就崩。
