一、問題背景

在用 高版本 JDK（如 JDK 17 或 21） 編譯一些老項(xiàng)目（比如 芋道 Yudao 項(xiàng)目）時(shí)，很多人會(huì)在 Maven 編譯日志中看到這樣的警告或報(bào)錯(cuò)：

[WARNING] 未與 -source 8 一起設(shè)置引導(dǎo)類路徑

或者（在某些終端環(huán)境下亂碼）：

[WARNING] δ?? -source 8 ?????????????·??

項(xiàng)目雖然能編譯通過，但終端里一堆奇怪的亂碼和警告，非常影響體驗(yàn)。

二、問題原因（用最簡單的話解釋）

其實(shí)，這不是你項(xiàng)目代碼的問題，而是 JDK 版本機(jī)制變化 導(dǎo)致的。

從 JDK 9 開始，javac 編譯器增加了一個(gè)新的參數(shù)：

--release 8

它的意思是：

“我雖然用的是 JDK 17（或 21）編譯，但請幫我生成一個(gè)兼容 Java 8 的程序。”

而舊的參數(shù)：

-source 1.8
-target 1.8

只告訴編譯器“我要用 Java 8 語法和目標(biāo)”，但不會(huì)自動(dòng)加載 Java 8 的類庫（比如 rt.jar）。

所以 JDK 17 編譯時(shí)就會(huì)警告你：

“你設(shè)置了 -source 8，但沒告訴我用哪個(gè)版本的類庫。”

三、我的項(xiàng)目場景（以芋道項(xiàng)目為例）

我在編譯芋道（Yudao）項(xiàng)目時(shí)遇到了這個(gè)問題。

pom.xml 里本來就寫了：

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

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

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

但依然報(bào)警告。

四、最終解決方案（實(shí)測可行）

我在 pom.xml 的 maven-compiler-plugin 配置中，手動(dòng)補(bǔ)上這三行：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>${maven-compiler-plugin.version}</version>
    <configuration>
        <!-- ? 補(bǔ)上這三行 -->
        <source>${java.version}</source>
        <target>${java.version}</target>
        <release>8</release>
    </configuration>
</plugin>

保存后重新執(zhí)行：

mvn clean package -Dmaven.test.skip=true

警告完全消失 ，整個(gè)項(xiàng)目編譯干干凈凈！

五、為什么加上<release>就能解決

因?yàn)椋?/p>

• -source 和 -target 只是告訴編譯器語法和目標(biāo)版本；
• --release 則會(huì)自動(dòng)選擇正確的 標(biāo)準(zhǔn)類庫（Java 8 的 rt.jar）；
• 所以 JDK 17/21 編譯器知道“我要用 8 的語法 + 8 的類庫”，不再報(bào)警。

簡單理解：

加上 <release>，就相當(dāng)于告訴編譯器：“我明確要編譯成 Java 8 環(huán)境的程序，別亂猜。”

六、總結(jié)一下

七、最終可直接復(fù)制的完整示例

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <!-- ? 解決警告的關(guān)鍵 -->
        <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>

八、總結(jié)一句話

當(dāng)你在 JDK 17/21 編譯 Java 8 項(xiàng)目（比如芋道）時(shí)，如果看到「未與 -source 8 一起設(shè)置引導(dǎo)類路徑」的警告，只需在 maven-compiler-plugin 里加上 <release>8</release>，一切問題立刻消失！

到此這篇關(guān)于Maven編譯報(bào)錯(cuò):未與 -source 8 一起設(shè)置引導(dǎo)類路徑的完美解決方案的文章就介紹到這了,更多相關(guān)Maven編譯報(bào)錯(cuò)解決內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論