执行Maven命令构建Apache IoTDB时下载停滞的原因与解决办法

可能的原因 #

• 依赖包过大或源节点连接不稳定：即便更换了国内Maven源，部分Apache官方依赖包体积较大，或是源节点负载过高，会导致下载速度极慢甚至看似停滞。
• Maven进程资源不足：本地内存、CPU被其他程序占用，Maven下载线程无法获取足够资源，进而陷入停滞状态。
• 本地缓存依赖损坏：~/.m2/repository中存在损坏的依赖包，Maven校验完整性时可能陷入长时间等待或死循环。
• 网络限制或代理问题：所在网络的防火墙、代理规则限制了Maven的网络请求，即便换源也无法建立稳定的下载连接。

解决办法 #

• 开启调试日志定位问题：执行构建命令时添加-X参数，命令改为：

  ~/iotdb$ mvn clean package -pl distribution -am -DskipTests -X
  

  通过日志可以明确当前正在下载的依赖包，精准定位停滞环节。
• 手动下载缺失依赖：根据调试日志找到卡住的依赖，手动下载后放置到本地Maven仓库对应路径（~/.m2/repository下的对应包目录）。
• 清理本地Maven缓存：删除~/.m2/repository中对应依赖的文件夹，或直接清空整个缓存目录（注意备份自定义依赖），之后重新执行构建命令。
• 增加Maven内存分配：修改~/.m2/settings.xml，添加内存配置的profile：

  <profile>
    <id>increase-memory</id>
    <properties>
      <maven.compiler.memoryInitialSize>1g</maven.compiler.memoryInitialSize>
      <maven.compiler.memoryMaximumSize>2g</maven.compiler.memoryMaximumSize>
    </properties>
  </profile>
  

  并在settings.xml的<activeProfiles>中激活该profile：

  <activeProfiles>
    <activeProfile>increase-memory</activeProfile>
  </activeProfiles>
  

• 排查网络与代理：确认本地网络是否有防火墙拦截，若使用代理，需在settings.xml中配置正确的代理信息；无代理则关闭系统代理后重试。
• 拆分构建步骤：先执行mvn clean install -DskipTests完成所有依赖的下载与安装，再执行目标构建命令，减少单次任务的压力。

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