快捷導(dǎo)航

idea Maven Springboot多模塊項(xiàng)目打包時(shí)90%的問(wèn)題及解決方案

更新時(shí)間：2025年08月04日 14:52:01 作者：紅塵丶世界

這篇文章主要介紹了idea Maven Springboot多模塊項(xiàng)目打包時(shí)90%的問(wèn)題及解決方案,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

1. 前言

之所以寫這篇文章是因?yàn)樵谑褂肕aven的過(guò)程中遇到了許多問(wèn)題，在這里作為記錄總結(jié)

2. 問(wèn)題

使用idea打包的時(shí)候編譯偶爾成功偶爾失敗，本地運(yùn)行能成功，有時(shí)能打包成功但是發(fā)現(xiàn)使用 jar 包跑的時(shí)候會(huì)出現(xiàn)類找不到的情況，最終經(jīng)過(guò)排查發(fā)現(xiàn)有部分的類打包的時(shí)候打包不進(jìn)去。

3. 解決辦法

關(guān)閉idea，找到對(duì)應(yīng)項(xiàng)目的目錄刪除 .idea 文件，讓 idea 去重構(gòu)項(xiàng)目

刪除 Maven 本地倉(cāng)庫(kù)下當(dāng)前項(xiàng)目的對(duì)應(yīng)的包，以 org.apache 為例，刪除該文件夾下的所有文件夾。

清除本地Maven 倉(cāng)庫(kù)中下載失敗的jar 包

#1. 創(chuàng)一個(gè).bat文件使用記事本打開(kāi) 
#2. 修改路徑為maven本地倉(cāng)庫(kù)路徑
#3. 保存退出，雙擊執(zhí)行
set REPOSITORY_PATH=D:\xxxx\apache-maven-3.3.9\repository
rem 正在搜索...
for /f "delims=" %%i in ('dir /b /s "%REPOSITORY_PATH%\*lastUpdated*"') do (
    del /s /q %%i
)
rem 搜索完畢
pause

刷新maven本地倉(cāng)庫(kù)，順便檢查一下 maven 配置和 maven 的jdk 配置

在idea中File -> settings -> -> Build,Execution -> Build Tools -> Maven -> repositories

重啟idea(當(dāng)然也可以選擇Reload，個(gè)人建議重啟idea)，reload 有時(shí)會(huì)出現(xiàn)更新不上的情況。

重啟后，會(huì)發(fā)現(xiàn)可能有部分模塊引用了其它模塊的jar會(huì)報(bào)錯(cuò)，這是正?，F(xiàn)象，這是因?yàn)槟銢](méi)有對(duì)公共模塊進(jìn)行打包，導(dǎo)致引入了公共模塊的其它模塊報(bào)錯(cuò)，但如果除了公共模塊之外還有其它的jar包還是報(bào)錯(cuò)這就得檢查一下maven 本地倉(cāng)庫(kù)是否下載成功了。

指定打包方式：

父項(xiàng)目指定打包方式為pom
公共模塊例如 common 、utils、Entity 這些模塊，建議打成jar包
可執(zhí)行模塊打成war 包

<! -- 具體指定打包方式，在pom文件的properties 上方添加： -->
<packaging>pom</packaging>
<packaging>jar</packaging>
<packaging>war</packaging>

在可執(zhí)行模塊添加 springboot maven 打包插件，其它模塊無(wú)需添加，最好指定主類。

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <mainClass>xxx.xxx.mainClass</mainClass>
                    <cleanCache>true</cleanCache>
                    <sourceDirectory>src/main/java</sourceDirectory>
                    <fork>true</fork>
                    <addResources>true</addResources>
                    <classifier>exec</classifier>
                </configuration>
            </plugin>
        </plugins>
    </build>

在公共項(xiàng)目先進(jìn)行打包