CentOS安装Maven实践

2025-09-15 09:58:52 作者：刘一说

文章详细介绍了在CentOS系统上安装配置Maven的步骤：检查Java环境、下载解压Maven、设置环境变量与本地仓库、配置阿里云镜像加速,并提供常见问题解决方案及验证方法,确保Maven正确安装与使用

Java 环境检查、Maven 下载与配置、环境变量设置、本地仓库配置

第一步：检查 Java 环境

Maven 是基于 Java 的工具，必须确保系统已安装 Java。

# 检查 Java 是否已安装
java -version

如果未安装 Java：

# 安装 OpenJDK 8（推荐）
sudo dnf install -y java-1.8.0-openjdk-devel

# 或安装 OpenJDK 11
sudo dnf install -y java-11-openjdk-devel

第二步：下载 Maven 安装包

方法 1：使用wget下载（推荐）

# 创建 Maven 安装目录（可选）
sudo mkdir -p /usr/local/maven

# 进入安装目录
cd /usr/local/maven

# 下载最新版本 Maven（以 3.9.6 为例）
sudo wget https://dlcdn.apache.org/maven/maven-3/3.9.11/binaries/apache-maven-3.9.11-bin.tar.gz

# 解压安装包
sudo tar -zxvf apache-maven-3.9.11-bin.tar.gz

方法 2：使用国内镜像加速下载

# 阿里云镜像（推荐国内用户）
sudo wget https://mirrors.aliyun.com/apache/maven/maven-3/3.9.11/binaries/apache-maven-3.9.11-bin.tar.gz

# 解压
sudo tar -zxvf apache-maven-3.9.11-bin.tar.gz

第三步：配置环境变量

1. 编辑系统环境变量文件

sudo vi /etc/profile

2. 在文件末尾添加以下内容（根据实际路径调整）：

# Maven 环境变量配置
export MAVEN_HOME=/usr/local/maven/apache-maven-3.9.11
export PATH=$MAVEN_HOME/bin:$PATH

3. 保存并退出编辑器（按Esc，输入:wq回车）。

4. 使配置立即生效

source /etc/profile

第四步：验证 Maven 安装

# 检查 Maven 版本
mvn -v

预期输出：

Apache Maven 3.9.11 (3e54c93a704957b63ee3494413a2b544fd3d825b)
Maven home: /usr/local/maven/apache-maven-3.9.11
Java version: 1.8.0_451, vendor: Oracle Corporation, runtime: /usr/lib/jvm/jdk1.8.0_451/jre
Default locale: zh_CN, platform encoding: UTF-8
OS name: "linux", version: "6.12.0-120.el10.x86_64", arch: "amd64", family: "unix"

第五步：配置 Maven 本地仓库和镜像

1. 修改 Maven 配置文件

sudo vi /usr/local/maven/apache-maven-3.9.11/conf/settings.xml

2. 配置本地仓库路径（可选）

<localRepository>/opt/maven/repository</localRepository>

3. 配置阿里云镜像（推荐国内用户）

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

4. 保存并退出编辑器（:wq）。

第六步：测试 Maven 功能

创建一个简单的 Maven 项目：

# 创建项目目录
mkdir ~/my-maven-project
cd ~/my-maven-project

# 使用 Maven 初始化项目
mvn archetype:generate -DgroupId=com.example \
                       -DartifactId=my-app \
                       -DarchetypeArtifactId=maven-archetype-quickstart \
                       -DinteractiveMode=false

# 编译项目
mvn compile

# 打包项目
mvn package

# 运行项目
java -cp target/my-app-1.0-SNAPSHOT.jar com.example.App

常见问题及解决方法

问题	解决方案
command not found: mvn	检查 /etc/profile 中 PATH 配置是否正确，运行 source /etc/profile
Maven 下载速度慢	使用阿里云镜像下载（如 https://mirrors.aliyun.com/apache/maven/...）
编译失败（Java 版本不匹配）	确保 JAVA_HOME 指向正确的 JDK 版本，检查 settings.xml 中的 JDK 配置

总结

步骤	内容
1. 检查 Java	确保系统已安装 Java（推荐 JDK 8 或 11）
2. 下载 Maven	从 Apache 官网或国内镜像下载 .tar.gz 包
3. 解压配置	解压到 /usr/local/maven 并配置 MAVEN_HOME
4. 验证安装	运行 mvn -v 确认安装成功
5. 配置镜像	修改 settings.xml 使用阿里云镜像加速依赖下载

完成！

现在您已成功在 CentOS 系统中安装并配置了 Maven。如果需要进一步优化（如配置私有仓库或代理），请参考 Maven 官方文档。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。