Maven项目拉取elasticsearch-java依赖失败，请求排查解决

环境信息 #

• Java版本：22
• Spring Boot版本：3.3.5
• Apache Maven版本：3.8.1
• 目标依赖：co.elastic.clients:elasticsearch-java:8.16.1

问题现象 #

引入该依赖后执行mvn clean install -X时出现repo.maven.apache.org连接超时；移除依赖后可正常拉取其他依赖（如com.fasterxml.jackson.core:jackson-databind）；切换至无代理公共WiFi后出现java.net.UnknownHostException: repo.maven.apache.org错误。

排查与修复步骤 #

1. 手动添加Elastic官方仓库 #

elasticsearch-java的部分传递依赖可能仅在Elastic官方仓库提供，而非Maven中央仓库。在pom.xml中添加以下仓库配置：

<repositories>
    <repository>
        <id>elastic-maven</id>
        <url>https://artifacts.elastic.co/maven</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

添加后重新执行mvn clean install尝试拉取依赖。

2. 检查Maven settings.xml配置 #

• 镜像配置：查看settings.xml中的<mirrors>节点，确认镜像地址是否能正常访问，且是否覆盖了所有仓库请求。部分镜像可能未同步elasticsearch-java相关包，导致拉取失败。可临时注释镜像配置测试。
• 代理配置：即使切换到无代理网络，settings.xml中残留的代理配置仍会生效。注释掉<proxies>下的代理条目，再执行Maven命令。
• 激活的Profile：检查<activeProfiles>节点，确认是否有特殊Profile覆盖了仓库配置。

3. 刷新本地DNS缓存 #

UnknownHostException通常是DNS解析失败导致，手动刷新缓存：

• Windows：运行命令提示符，执行 ipconfig /flushdns
• macOS：终端执行 sudo dscacheutil -flushcache
• Linux：终端执行 sudo systemctl restart nscd（部分发行版可用 sudo systemctl restart systemd-resolved）

4. 清理本地Maven仓库缓存 #

本地仓库中损坏的缓存文件可能导致拉取失败，删除本地仓库路径下co/elastic目录，然后执行：

mvn clean install -U

-U参数强制Maven更新依赖，绕过本地缓存。

5. 检查依赖树与传递性问题 #

执行以下命令生成完整依赖树，排查是否存在冲突或特殊依赖：

mvn dependency:tree -Dverbose

查看是否有依赖指向无法访问的仓库，或尝试排除疑似有问题的传递依赖（需谨慎操作，避免破坏依赖完整性）。

6. 测试仓库连通性 #

直接通过浏览器或curl访问https://repo.maven.apache.org/maven2/co/elastic/clients/elasticsearch-java/8.16.1/，确认是否能正常获取文件：

• 若无法访问：排查网络防火墙、ISP限制等网络层面问题
• 若能访问：回到Maven配置，检查是否有配置拦截了请求

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