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

一、问题背景

在用 高版本 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.xml 的 maven-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>就能解决

因为：

-source 和 -target 只是告诉编译器语法和目标版本；
--release 则会自动选择正确的 标准类库（java 8 的 rt.jar）；
所以 jdk 17/21 编译器知道“我要用 8 的语法 + 8 的类库”，不再报警。

简单理解：

加上 <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>