Maven执行clean install报错：环境无编译器，疑为JRE而非JDK运行

阿华AIGC实验室

2026-5-21

解决Maven编译错误：No compiler is provided in this environment. Perhaps you are running on a JRE rather than a JDK?

我之前碰到过好多次这个问题，核心原因就是Maven找不到JDK自带的javac编译器——哪怕你觉得环境变量配好了，也可能有几个容易忽略的细节没处理到位，下面是我亲测有效的解决步骤：

先确认你装的是JDK而非单纯的JRE
JRE只是Java运行环境，没有编译工具javac。打开你的Java安装目录，看看bin文件夹里有没有javac.exe（Windows）或javac（Linux/Mac）。也可以在控制台运行javac -version，如果报错说“找不到命令”，那说明你要么没装JDK，要么JDK的bin目录没加到环境变量里。

检查Maven的JDK配置（强制指定更靠谱）
有时候系统环境变量没问题，但Maven没正确识别。可以在项目的pom.xml里配置maven-compiler-plugin，明确指定JDK的编译器路径：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version> <!-- 用最新稳定版也行 -->
            <configuration>
                <source>1.8</source> <!-- 对应你的JDK版本，比如11、17 -->
                <target>1.8</target>
                <fork>true</fork>
                <executable>C:\Program Files\Java\jdk1.8.0_301\bin\javac.exe</executable> <!-- 替换成你的JDK实际路径 -->
            </configuration>
        </plugin>
    </plugins>
</build>

或者在Maven全局的settings.xml（一般在conf文件夹下）里添加profile，让所有项目默认用JDK：

<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>
        </properties>
    </profile>
</profiles>

IDE运行的话，检查IDE的JDK配置
如果是用IDEA或Eclipse执行Maven命令，别光看系统环境变量，还要检查IDE自身的配置：
- IDEA：File -> Project Structure -> SDKs，确保选中的是JDK（不是JRE）；再到Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Runner，把JRE选项改成Project SDK。
- Eclipse：Window -> Preferences -> Java -> Installed JREs，点击Add选择JDK的安装目录，设为默认；然后右键项目Properties -> Java Build Path -> Libraries，把原来的JRE System Library换成JDK。
验证环境变量是否真的生效
很多人改了环境变量后没重启控制台，导致新的变量没加载。打开一个全新的控制台，运行：
- Windows：echo %JAVA_HOME%，看输出是不是JDK的路径；再运行echo %PATH%，确认%JAVA_HOME%\bin在里面。
- Linux/Mac：echo $JAVA_HOME和echo $PATH，同理检查路径是否正确。