maven未安装或配置不正确时，可通过sdkman!一键安装（如sdk install maven 3.9.6）、手动解压配置环境变量（/opt/maven）、配置阿里云镜像源加速依赖下载、并显式设置java_home确保jdk兼容。
如果您尝试在Linux系统中使用Maven构建Java项目，但执行mvn -v命令提示command not found或版本过低，则说明Maven未安装或配置不正确。以下是多种可靠、可复现的安装与配置方法：
一、使用SDKMAN!安装并管理Maven版本
SDKMAN! 是专为Java生态设计的版本管理工具，支持一键安装、多版本共存与快速切换，避免项目间因Maven版本差异导致的依赖解析失败或生命周期阶段报错。
1、执行安装脚本：curl -s "https://get.sdkman.io" | bash
2、初始化SDKMAN!环境：source "$HOME/.sdkman/bin/sdkman-init.sh"
3、列出可用Maven版本：sdk list maven，确认输出中包含带*号的推荐稳定版（如3.9.6）
4、安装指定版本：sdk install maven 3.9.6
5、验证安装结果：mvn -v，输出应显示Apache Maven 3.9.6及兼容的JDK版本信息
二、手动解压安装并配置全局环境变量
该方式适用于离线环境、内网服务器或需精确控制安装路径与权限的场景，要求确保MAVEN_HOME路径、PATH注入及文件权限三者严格一致，否则将触发JAVA_HOME not set或tools.jar not found错误。
1、创建统一安装目录：sudo mkdir -p /opt/maven
2、下载官方二进制包（以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
3、解压至目标目录：sudo tar -xzf apache-maven-3.9.6-bin.tar.gz -C /opt/ && sudo ln -sf /opt/apache-maven-3.9.6 /opt/maven
4、新建系统级环境配置文件：sudo vi /etc/profile.d/maven.sh，写入以下两行：
export MAVEN_HOME=/opt/maven
export PATH=$MAVEN_HOME/bin:$PATH
5、使配置全局生效：sudo chmod +x /etc/profile.d/maven.sh && source /etc/profile.d/maven.sh
6、验证命令可用性：mvn -v，确认输出中Maven home指向/opt/maven
三、配置阿里云镜像源加速依赖下载
默认中央仓库位于海外，国内直连常出现超时、连接重置或依赖拉取失败问题。修改settings.xml可强制所有项目使用阿里云公共镜像，显著提升mvn compile与mvn install执行效率。
1、定位配置文件路径：ls $MAVEN_HOME/conf/settings.xml
2、备份原始文件：sudo cp $MAVEN_HOME/conf/settings.xml $MAVEN_HOME/conf/settings.xml.bak
3、编辑配置文件：sudo vi $MAVEN_HOME/conf/settings.xml
4、在<mirrors></mirrors>标签内插入以下镜像配置：
<mirror></mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorof>central</mirrorof>
5、保存退出后，执行mvn help:effective-settings确认alimaven已生效
四、验证JDK兼容性并设置JAVA_HOME
Maven是基于Java开发的工具，其运行强依赖JDK环境；若java -version正常但mvn -v报JAVA_HOME not set，说明Maven未识别到JDK安装路径，必须显式声明。
1、确认已安装JDK 8或更高版本：java -version，输出应含1.8、11、17或21
2、查询JDK实际路径：readlink -f $(which java) | sed "s:/jre/bin/java::"
3、将结果路径写入Maven环境变量文件（如/etc/profile.d/maven.sh）：
export JAVA_HOME=<strong><font color="green">/usr/lib/jvm/java-17-openjdk-amd64</font></strong>
4、重新加载配置：source /etc/profile.d/maven.sh
5、再次执行mvn -v，输出中Java home字段应与JAVA_HOME值完全一致
