Maven环境配置失败的根源在于JDK未正确安装、JAVA_HOME路径错误、Maven未加入PATH、镜像未配置导致依赖下载失败，需依次验证JDK版本、设置JAVA_HOME、安装Maven并配置PATH、配置阿里云镜像、创建项目验证打包流程。
当你在终端输入 mvn clean install 却收到 command not found: mvn 或者构建卡在下载依赖、报 Connection refused 错误时，说明 Maven 环境没配对、镜像没生效、或本地仓库权限异常——这不是项目代码的问题，而是基础环境链断裂了。
确认 JDK 已就位且 JAVA_HOME 正确指向根目录
打开终端，执行：java -version。如果输出不是 JDK 17 或 JDK 21 的版本号（如 17.0.1），说明 JDK 没装或没生效。
【JAVA_HOME 必须指向 JDK 根目录，不是 bin 子目录】。比如 JDK 解压在 /Library/Java/JavaVirtualMachines/corretto-17.jdk/Contents/Home，那 JAVA_HOME 就该设成这个完整路径，不能是 .../Home/bin——否则 Maven 启动时会找不到 javac，后续所有构建都会失败。
检查当前 JAVA_HOME：运行 echo $JAVA_HOME。若为空或路径错误，在 ~/.zshrc（macOS）或 ~/.bashrc（Linux）末尾添加：export JAVA_HOME=/path/to/your/jdk，然后执行 source ~/.zshrc 生效。
安装 Maven 并验证 bin 目录已加入 PATH
从 Apache 官网 下载 apache-maven-3.9.8-bin.tar.gz（macOS/Linux）或 -bin.zip（Windows），解压到无中文、无空格路径，例如 /opt/maven。
编辑 ~/.zshrc，追加两行：
export MAVEN_HOME=/opt/mavenexport PATH=$PATH:$MAVEN_HOME/bin
保存后执行 source ~/.zshrc，再运行 mvn -v。看到 Maven 版本、Java 版本、Java home 路径三行输出，才算真正就绪。
配置阿里云镜像加速依赖下载
不改镜像，Maven 默认连国外中央仓库，90% 的构建会在 Downloading from central: 卡死 2 分钟以上，甚至超时失败。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
找到 Maven 安装目录下的 conf/settings.xml 文件，在 <mirrors></mirrors> 标签内插入以下内容（注意不要嵌套在已有
<mirror></mirror> <id>nexus-aliyun</id> <mirrorof>central</mirrorof> <name>Nexus aliyun</name> <url>https://maven.aliyun.com/nexus/content/groups/public</url>
保存文件。这一步必须做，否则后续任何 mvn compile 或 mvn package 都可能因网络问题中断。
创建标准 Maven 项目并快速验证打包流程
第一步：在终端中执行命令生成骨架项目：mvn archetype:generate -DgroupId=com.example -DartifactId=demo-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false。
第二步：进入项目目录：cd demo-app。
第三步：修改 pom.xml，在 <build><plugins></plugins></build> 内添加可执行 JAR 打包插件（否则 mvn package 只生成普通 JAR，无法 java -jar 运行）：
<plugin></plugin> <groupid>org.apache.maven.plugins</groupid> <artifactid>maven-jar-plugin</artifactid> <version>3.3.0</version> <configuration></configuration> <archive></archive> <manifest></manifest> <addclasspath>true</addclasspath> <mainclass>com.example.App</mainclass>
第四步：执行完整构建流程：mvn clean compile test package。成功后，target/demo-app-1.0-SNAPSHOT.jar 就生成了。
第五步：验证是否可直接运行：java -jar target/demo-app-1.0-SNAPSHOT.jar。终端输出 Hello World! 即表示整个链路打通。
