问题场景在 Maven 多模块 Spring Boot 项目打包时突然报错Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.14.0:compile The plugin requires Maven version 3.6.3检查一下自己的 Maven 版本mvn --version # Apache Maven 3.6.1好家伙2019 年的老古董确实该升级了。第一步下载解压以为完事了去 Maven 官网 下载 3.9.9 版本解压到E:\JavaWeb_study\apache-maven-3.9.9。打开终端一跑 ——还是 3.6.1。于是就开始了漫长的环境变量排查之路……第二步肉眼翻环境变量翻了个寂寞Win R→sysdm.cpl→ 高级 → 环境变量上半部分用户变量Path里没有 Maven 路径下半部分系统变量挤得满满当当用眼睛一个一个字地扫愣是没找到这时候改用命令行查一行就定位了# 精确找到 mvn 命令的来源 Get-Command mvn | Select-Object Source # 输出E:\JavaWeb_study\apache-maven-3.6.1-bin\apache-maven-3.6.1\bin\mvn.cmd再查环境变量# 查系统变量中的 MAVEN_HOME [Environment]::GetEnvironmentVariable(MAVEN_HOME, Machine) # 输出E:\JavaWeb_study\apache-maven-3.6.1-bin\apache-maven-3.6.1 # 查系统 PATH 中包含 maven 的条目 [Environment]::GetEnvironmentVariable(Path, Machine) -split ; | Select-String maven # 输出E:\JavaWeb_study\apache-maven-3.6.1-bin\apache-maven-3.6.1\bin真相大白旧 Maven 同时藏在系统Path和系统MAVEN_HOME里GUI 里路径太长根本看不见。第三步改 PATH 以为搞定了结果白改先用普通权限把新路径加到用户 PATH[Environment]::SetEnvironmentVariable(Path, 新路径; $oldPath, User)又把用户变量MAVEN_HOME改成新路径[Environment]::SetEnvironmentVariable(MAVEN_HOME, E:\JavaWeb_study\apache-maven-3.9.9, User)关掉终端重新打开mvn --version——还是 3.6.1第四步定位根因——系统变量 vs 用户变量的优先级排查后发现问题所在变量作用域值状态MAVEN_HOME用户变量...apache-maven-3.9.9✅ 已改MAVEN_HOME系统变量...apache-maven-3.6.1❌ 还是旧的Path用户变量开头已加 3.9.9✅Path系统变量中间夹着 3.6.1❌核心知识点系统变量的优先级 ≥ 用户变量。即使你改了用户变量只要系统变量里有同名条目系统变量会覆盖它。而且修改系统变量必须管理员权限普通 PowerShell 改不动。另外Maven 的mvn.cmd启动脚本内部靠MAVEN_HOME变量定位核心库不修改MAVEN_HOME光改Path是没用的。第五步终极修复管理员权限右键命令提示符→以管理员身份运行执行以下命令:: 1. 把系统级 MAVEN_HOME 指向新版本 setx MAVEN_HOME E:\JavaWeb_study\apache-maven-3.9.9 /M :: 2. 从系统 Path 中删除旧 Maven 路径PowerShell 命令 powershell -Command $p[Environment]::GetEnvironmentVariable(Path,Machine);$p$p -replace E:\\JavaWeb_study\\apache-maven-3.6.1-bin\\apache-maven-3.6.1\\bin;?,;[Environment]::SetEnvironmentVariable(Path,$p,Machine)参数说明/M参数表示写入系统变量Machine-replace用正则把旧路径从 PATH 中移除关掉所有终端重新打开验证mvn --version # Apache Maven 3.9.9 ✅总结一张图搞清楚 Windows 环境变量┌─────────────────────────────────────────────┐ │ Windows 环境变量层级 │ ├─────────────────────────────────────────────┤ │ 用户变量User │ │ ├── 优先级低 │ │ ├── 修改权限普通用户即可 │ │ └── 作用范围仅当前用户 │ │ │ │ 系统变量Machine ← 优先级更高 │ │ ├── 优先级高覆盖同名用户变量 │ │ ├── 修改权限需要管理员 │ │ └── 作用范围所有用户 │ └─────────────────────────────────────────────┘几个实用的排查命令收藏备用# 查某个命令的实际位置 Get-Command mvn | Select-Object Source # 查指定变量User / Machine [Environment]::GetEnvironmentVariable(MAVEN_HOME, User) [Environment]::GetEnvironmentVariable(MAVEN_HOME, Machine) # 从长 PATH 中过滤关键字 [Environment]::GetEnvironmentVariable(Path, Machine) -split ; | Select-String java # 设置用户变量 setx 变量名 值 # 设置系统变量需管理员 setx 变量名 值 /M后记这个问题本质上不难但坑在两点Windows 环境变量编辑器太难用PATH 长的时候完全没法翻命令行查比 GUI 快十倍系统变量 vs 用户变量的优先级不搞清楚的话改了白改。希望这篇踩坑记录能帮你少走弯路 ✌️
)
