java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > Maven编译报错解决

Maven编译报错:未与 -source 8 一起设置引导类路径的完美解决方案

作者:一勺菠萝丶

这篇文章主要为大家详细介绍了Maven编译报错:未与 -source 8 一起设置引导类路径的相关解决方案,文中的示例代码讲解详细,有需要的小伙伴可以了解下

一、问题背景

在用 高版本 JDK(如 JDK 17 或 21) 编译一些老项目(比如 芋道 Yudao 项目)时,很多人会在 Maven 编译日志中看到这样的警告或报错:

[WARNING] 未与 -source 8 一起设置引导类路径

或者(在某些终端环境下乱码):

[WARNING] δ�� -source 8 һ������������·��

项目虽然能编译通过,但终端里一堆奇怪的乱码和警告,非常影响体验。

二、问题原因(用最简单的话解释)

其实,这不是你项目代码的问题,而是 JDK 版本机制变化 导致的。

JDK 9 开始javac 编译器增加了一个新的参数:

--release 8

它的意思是:

“我虽然用的是 JDK 17(或 21)编译,但请帮我生成一个兼容 Java 8 的程序。”

而旧的参数:

-source 1.8
-target 1.8

只告诉编译器“我要用 Java 8 语法和目标”,但不会自动加载 Java 8 的类库(比如 rt.jar)。

所以 JDK 17 编译时就会警告你:

“你设置了 -source 8,但没告诉我用哪个版本的类库。”

三、我的项目场景(以芋道项目为例)

我在编译芋道(Yudao)项目时遇到了这个问题。

pom.xml 里本来就写了:

<properties>
    <java.version>1.8</java.version>
</properties>

并且 maven-compiler-plugin 中也配置了:

<source>${java.version}</source>
<target>${java.version}</target>

但依然报警告。

四、最终解决方案(实测可行)

我在 pom.xmlmaven-compiler-plugin 配置中,手动补上这三行

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>${maven-compiler-plugin.version}</version>
    <configuration>
        <!-- ✅ 补上这三行 -->
        <source>${java.version}</source>
        <target>${java.version}</target>
        <release>8</release>
    </configuration>
</plugin>

保存后重新执行:

mvn clean package -Dmaven.test.skip=true

警告完全消失 ,整个项目编译干干净净!

五、为什么加上<release>就能解决

因为:

简单理解:

加上 <release>,就相当于告诉编译器:“我明确要编译成 Java 8 环境的程序,别乱猜。”

六、总结一下

项目环境问题表现解决方式
使用 JDK 17 / 21 编译旧项目出现 未与 -source 8 一起设置引导类路径 警告在 maven-compiler-plugin 中添加 <release>8</release>
原因JDK 9+ 之后 javac 要求明确指定类库版本使用 <release> 告诉编译器目标类库
推荐做法在 pom.xml 添加三行配置适用于所有 JDK 版本,最稳定

七、最终可直接复制的完整示例

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <!-- ✅ 解决警告的关键 -->
        <source>${java.version}</source>
        <target>${java.version}</target>
        <release>8</release>

        <!-- 可选:注解处理器配置 -->
        <annotationProcessorPaths>
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>1.18.32</version>
            </path>
        </annotationProcessorPaths>
    </configuration>
</plugin>

八、总结一句话

当你在 JDK 17/21 编译 Java 8 项目(比如芋道)时,如果看到「未与 -source 8 一起设置引导类路径」的警告,只需在 maven-compiler-plugin 里加上 <release>8</release>,一切问题立刻消失!

到此这篇关于Maven编译报错:未与 -source 8 一起设置引导类路径的完美解决方案的文章就介绍到这了,更多相关Maven编译报错解决内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:
阅读全文