Linux系统安装配置Apache Maven 加速项目构建换源教程【教程】

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《Linux系统安装配置Apache Maven 加速项目构建换源教程【教程】》，这篇文章主要讲到等等知识，如果你对文章相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

Linux装Maven失败主因是环境变量或镜像配置错误；mvn compile超时因未换阿里云等HTTPS镜像源；需先确认JDK已安装且JAVA_HOME正确，再手动解压安装并配置MAVEN_HOME与PATH，最后修改settings.xml启用阿里云镜像。

Maven 在 Linux 上装不起来，八成卡在环境变量或镜像配置上；装起来了但 mvn compile 拉依赖超时，基本是没换源或用了已失效的 HTTP 镜像。

确认 Java 已就位再碰 Maven

没有可用的 JDK，mvn 命令会直接报错 JAVA_HOME not set 或静默失败。Maven 3.9+ 要求 JDK 8+（推荐 JDK 11/17），但不会自动校验兼容性。

• 运行 java -version，输出必须含版本号（如 17.0.10）和 vendor（如 Eclipse Adoptium）
• 若无输出，先装 JDK：Ubuntu/Debian 用 sudo apt install openjdk-17-jdk；CentOS/RHEL 用 sudo yum install java-17-openjdk-devel
• 确保 JAVA_HOME 已设且指向 JDK 根目录（不是 jre 子目录），例如 /usr/lib/jvm/java-17-openjdk-amd64

手动安装 Maven 并让 mvn 全局可用

Linux 发行版仓库里的 Maven 版本普遍滞后（如 Ubuntu 22.04 自带 3.6.3），而新项目常依赖 3.8.6+ 的插件行为。手动解压 + 环境变量是最可控的方式。

• 下载最新稳定版（如 3.9.6）：wget https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
• 解压到系统级路径：sudo tar -xzf apache-maven-3.9.6-bin.tar.gz -C /opt/
• 建软链接方便后续升级：sudo ln -sf /opt/apache-maven-3.9.6 /opt/maven
• 写入系统级环境变量：echo 'export MAVEN_HOME=/opt/maven' | sudo tee /etc/profile.d/maven.sh && echo 'export PATH=$MAVEN_HOME/bin:$PATH' | sudo tee -a /etc/profile.d/maven.sh
• 立即生效：source /etc/profile.d/maven.sh

执行 mvn -v，输出中 Maven home 应为 /opt/maven，且 Java version 行不为空。

换阿里云镜像源避免 Connection timed out

默认中央仓库 https://repo.maven.apache.org/maven2/ 国内直连极不稳定，常见错误包括 Failed to transfer、Could not find artifact，本质是 DNS 解析慢或连接被重置。

• 编辑全局配置：sudo vi $MAVEN_HOME/conf/settings.xml
• 在 标签内插入（注意：必须放在 内部，不能在外面）：

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

• 关键点：* 表示覆盖所有仓库（包括 central、spring-plugins 等），比旧式 central 更彻底；URL 必须用 https（Maven 3.8.1+ 默认禁用 HTTP 镜像）
• 改完保存，无需重启，下次 mvn clean compile 就会走新源

本地仓库路径与权限别踩坑

默认本地仓库在 ~/.m2/repository，但多人共用服务器或磁盘空间紧张时，常需迁移到大容量盘（如 /data/maven_repo）。这里容易出两个问题：路径不存在、权限不足。

• 先创建目录并赋权：sudo mkdir -p /data/maven_repo && sudo chown $USER:$USER /data/maven_repo
• 在 $MAVEN_HOME/conf/settings.xml 的 根标签内添加：

<localRepository>/data/maven_repo</localRepository>

• 切勿用 root 运行 mvn 初始化仓库——会导致 /data/maven_repo 下文件属主为 root，后续普通用户无法写入
• 验证方式：执行一次 mvn help:system，然后 ls -l /data/maven_repo，确认子目录由当前用户拥有

镜像源和本地仓库这两处改完，mvn dependency:resolve 应能在 10 秒内完成基础依赖拉取；如果仍卡住，优先检查 settings.xml 是否有语法错误（如未闭合标签）、是否误加了空格导致 XML 解析失败。

好了，本文到此结束，带大家了解了《Linux系统安装配置Apache Maven 加速项目构建换源教程【教程】》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！