Spring MVC项目Maven编译失败求助：环境无编译器问题

嘿，这个问题我碰到好多次了，本质就是Maven找不到JDK里的javac编译器——当前环境默认绑定了JRE，而JRE是不带编译工具的。下面几个步骤一步步排查，肯定能解决：

1. 先检查IDE的JDK配置（如果用IDE构建项目） #

不管是Eclipse还是IntelliJ，IDE很可能默认用了JRE而非JDK：

• Eclipse操作：
  1. 打开 Window > Preferences > Java > Installed JREs
  2. 确保列表里的路径指向JDK根目录（比如C:\Program Files\Java\jdk1.8.0_301），不是JRE的路径
  3. 再检查项目Build Path：右键项目 > Build Path > Configure Build Path，把JRE System Library替换成刚才选中的JDK
• IntelliJ IDEA操作：
  1. 打开 File > Project Structure > Project Settings > Project
  2. 把Project SDK设置为JDK 1.8，Project language level选8
  3. 再进入 Modules > Sources 确认Language Level也是8

2. 验证系统环境变量JAVA_HOME #

这是最常见的诱因，JAVA_HOME必须指向JDK的根目录，绝对不能是JRE：

• Windows系统：
  1. 右键「此电脑」> 属性 > 高级系统设置 > 环境变量
  2. 检查JAVA_HOME的值，格式应该是C:\Program Files\Java\jdk1.8.0_301（不要带\bin后缀）
  3. 确保Path里添加了%JAVA_HOME%\bin，让系统能找到javac命令
  4. 打开命令提示符，输入javac -version，如果能显示JDK版本，说明配置生效
• Linux/macOS系统：
  1. 打开终端，输入echo $JAVA_HOME，查看输出是否为JDK的正确路径
  2. 如果不对，编辑~/.bashrc（或~/.zshrc），添加：

     export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Home
     export PATH=$JAVA_HOME/bin:$PATH
     

  3. 执行source ~/.bashrc生效，再输入javac -version验证

3. 配置Maven的settings.xml（全局/项目级） #

可以在Maven配置里强制指定JDK，规避环境变量的不确定性：

1. 找到Maven安装目录下的conf/settings.xml，或者用户目录下的.m2/settings.xml
2. 在<profiles>标签内添加：

   <profile>
       <id>jdk-1.8</id>
       <activation>
           <activeByDefault>true</activeByDefault>
           <jdk>1.8</jdk>
       </activation>
       <properties>
           <maven.compiler.source>1.8</maven.compiler.source>
           <maven.compiler.target>1.8</maven.compiler.target>
           <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
           <!-- 如果还是不行，直接指定javac的绝对路径 -->
           <maven.compiler.executable>${JAVA_HOME}/bin/javac</maven.compiler.executable>
       </properties>
   </profile>
   

4. 在项目pom.xml中直接指定编译插件 #

这是最直接的项目级保障，强制Maven用指定JDK编译：
在<build>标签下添加maven-compiler-plugin的配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version> <!-- 选择适配JDK1.8的插件版本 -->
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <compilerVersion>1.8</compilerVersion>
                <!-- 可选：直接写死javac路径，彻底避开环境变量问题 -->
                <executable>C:\Program Files\Java\jdk1.8.0_301\bin\javac.exe</executable>
            </configuration>
        </plugin>
    </plugins>
</build>

完成上面任意步骤后，重新执行mvn clean install，应该就能正常编译了！

内容的提问来源于stack exchange，提问作者Sreevidya Aravind