MacBook多版本Maven问题求助：修复报错、切换版本及卸载旧版

1. 修复新版本Maven启动报错 #

报错原因 #

你的环境变量（MAVEN_OPTS或JAVA_OPTS）中配置了重复的JDWP调试参数，以及Java 8已废弃的MaxPermSize参数，导致新版本Maven启动时JVM初始化冲突。

修复步骤 #

• 检查当前环境变量配置：

  echo $MAVEN_OPTS
  echo $JAVA_OPTS
  

  查看输出中是否包含 -agentlib:jdwp=transport=dt_socket,address=5005,suspend=n,server=y（重复调试参数）或 -XX:MaxPermSize=384m（过时参数）。
• 找到配置上述变量的文件（常见为~/.zshrc、~/.bash_profile、~/.profile，或公司工具的专属配置脚本），删除重复的JDWP参数，以及所有MaxPermSize相关配置。
• 重启终端，或执行source ~/.zshrc（对应你的shell配置文件）使修改生效，再运行以下命令验证：

  /opt/homebrew/Cellar/maven/3.9.1/bin/mvn -v
  

2. 在项目构建时切换到Maven 3.9.1 #

提供三种切换方式，按需选择：

临时切换（单次终端会话生效） #

直接使用新版本的绝对路径执行命令：

/opt/homebrew/Cellar/maven/3.9.1/bin/mvn clean install

或临时设置别名：

alias mvn391='/opt/homebrew/Cellar/maven/3.9.1/bin/mvn'
mvn391 -v

永久切换（全局默认使用新版本） #

修改shell配置文件，将brew安装的Maven路径放到PATH最前面：

echo 'export PATH="/opt/homebrew/Cellar/maven/3.9.1/bin:$PATH"' >> ~/.zshrc

执行source ~/.zshrc生效后，直接运行mvn -v即可调用3.9.1版本。

项目级切换（仅指定项目使用新版本） #

推荐使用Maven Wrapper，确保项目构建版本不受本地环境影响：

1. 进入目标项目根目录，执行：

   /opt/homebrew/Cellar/maven/3.9.1/bin/mvn wrapper:wrapper -Dmaven=3.9.1
   

2. 项目根目录会生成mvnw脚本，后续使用./mvnw clean install代替mvn命令，将自动使用3.9.1版本构建。

3. 关于删除Maven 3.1.1的说明 #

可以删除，但需先确认：

• 公司其他项目是否依赖3.1.1版本，或公司工具是否会自动重新安装该版本。
• 环境变量中是否仍有指向该版本的配置（如PATH条目、MAVEN_HOME）。

删除步骤 #

1. 删除旧版本安装目录：

   rm -rf /Users/abc/.bootstrap/packages/maven3.1.1/apache-maven-3.1.1
   

2. 检查shell配置文件及公司工具脚本，删除所有指向3.1.1版本的环境变量配置。
3. 重启终端验证，确保mvn -v不再指向3.1.1版本。

内容的提问来源于stack exchange，提问作者Gengis Khan