Mac环境下如何为Maven切换Java版本

1. 检查JAVA_HOME环境变量 #

Maven会优先读取JAVA_HOME指向的JDK版本，而非系统默认的java命令版本：

• 执行echo $JAVA_HOME，查看输出路径是否对应Java 22的安装目录
• 如果是，修改JAVA_HOME指向Java 17：
  • 若用bash，编辑~/.bash_profile或~/.bashrc，添加/修改：

    export JAVA_HOME=$(/usr/libexec/java_home -v 17)
    export PATH=$JAVA_HOME/bin:$PATH
    

  • 若用zsh，编辑~/.zshrc，添加同样内容
  • 执行source ~/.zshrc（对应你的shell）使配置生效，再运行mvn -version验证

2. 检查Maven全局配置文件 #

Maven的全局或用户级settings.xml可能指定了JDK版本：

• 找到Maven安装目录下的conf/settings.xml（如/usr/local/apache-maven/conf/settings.xml），或用户目录下的~/.m2/settings.xml
• 检查是否存在激活的JDK 22配置，比如：

  <profile>
    <id>jdk-22</id>
    <activation>
      <activeByDefault>true</activeByDefault>
    </activation>
    <properties>
      <maven.compiler.source>22</maven.compiler.source>
      <maven.compiler.target>22</maven.compiler.target>
    </properties>
  </profile>
  

• 将版本改为17，或删除该profile，让Maven沿用JAVA_HOME指定的版本

3. 检查项目本地pom.xml配置 #

单个项目的pom.xml可能覆盖全局配置：

• 打开项目的pom.xml，检查以下两处配置：

  <!-- 检查properties节点 -->
  <properties>
    <maven.compiler.source>22</maven.compiler.source>
    <maven.compiler.target>22</maven.compiler.target>
  </properties>
  
  <!-- 或检查maven-compiler-plugin配置 -->
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
          <source>22</source>
          <target>22</target>
        </configuration>
      </plugin>
    </plugins>
  </build>
  

• 将上述配置中的版本改为17即可

4. 检查第三方JDK管理工具（如jenv、jabba） #

如果用了JDK管理工具，可能单独配置了Maven的JDK版本：

• 以jenv为例，执行jenv versions查看当前全局/本地JDK版本，执行jenv global 17设置全局默认，或在项目目录执行jenv local 17设置项目专属版本
• 确保启用jenv的maven插件：jenv enable-plugin maven，重启终端后验证

5. 检查Maven启动脚本硬编码 #

极少情况下，Maven启动脚本可能硬编码了JDK路径：

• 找到Maven安装目录下的bin/mvn文件，打开检查是否有JAVA_HOME=/path/to/jdk22这类硬编码配置
• 若有，修改为Java 17的路径，或删除该行让脚本读取系统JAVA_HOME

内容的提问来源于stack exchange，提问作者Nikunj Aggarwal