Hello，大家好，我是樓下小黑哥~

我們本地使用 IDEA 運(yùn)行 maven 項(xiàng)目的時(shí)候，有時(shí)候運(yùn)氣不好，就會(huì)遇到某些 maven 依賴無法正常找到、導(dǎo)入。這就會(huì)導(dǎo)致 IDEA  構(gòu)建項(xiàng)目的時(shí)候爆出一堆醒目的紅色 Error。

那最近小黑哥新拉取一個(gè)項(xiàng)目源碼，本地運(yùn)行項(xiàng)目，又碰到這種情況。按照以前的解決經(jīng)驗(yàn)，搗鼓了一下，發(fā)現(xiàn)沒辦法解決。于是研究了一下午，終于解決這個(gè)問題??。

吐槽一下，剛開始一度以為是這個(gè)項(xiàng)目有問題，找了一個(gè)同事，發(fā)現(xiàn)他的電腦是卻可以正常運(yùn)行這個(gè)項(xiàng)目。

那今天這篇的文章，總結(jié)一下 IDEA 運(yùn)行 maven 項(xiàng)目找不到相關(guān)依賴報(bào)錯(cuò)的問題原因以及解決辦法。

網(wǎng)絡(luò)問題，無法下載 maven 依賴

Maven 默認(rèn)的中央倉庫地址為 http://search.maven.org/#browse，那這是一個(gè)外網(wǎng)的地址。

而我們國內(nèi)訪問外網(wǎng)地址，網(wǎng)絡(luò)速度不僅慢，網(wǎng)絡(luò)質(zhì)量還差。這就導(dǎo)致了maven 依賴下載速度過慢，有時(shí)候下載還可能會(huì)失敗。

maven 依賴下載失敗，這就會(huì)導(dǎo)致 IDEA 找不到相關(guān)依賴。

那這個(gè)問題解決辦法也比較簡單，我們可以通過設(shè)置鏡像(mirrors)地址解決。

打開我們本地 maven 配置文件，默認(rèn)地址如下:${user.home}/.m2/settings.xml，然后找到 mirrors節(jié)點(diǎn)，在這下面添加以下配置：

<mirrors>
    <mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
      <mirrorOf>central</mirrorOf>        
    </mirror>
</mirrors>

lastUpdated 文件導(dǎo)致依賴無法正常導(dǎo)入

當(dāng)你更新鏡像地址之后，有可能還會(huì)碰到 maven 依賴無法導(dǎo)入，那恭喜你碰到第二個(gè)問題了。

maven 依賴下載的時(shí)候，如果碰到網(wǎng)絡(luò)較差，依賴下載失敗，maven 本地將會(huì)生成 lastUpdated 為后綴的文件。

那正常的 maven 依賴如下

lastUpdated 為后綴的文件作用如下：

只要 lastUpdated 文件存在，maven 依賴將不會(huì)重新下載，所以做簡單的方法就是，刪除 lastUpdated 文件，重新刷新下載即可。

這里提供一鍵刪除 lastUpdated 文件腳本(macos)

# 這里寫你的倉庫路徑
REPOSITORY_PATH=~/.m2/repository
echo 正在搜索...
find $REPOSITORY_PATH -name "*lastUpdated*" | xargs rm -fr
echo 搜索完

windows 腳本如下：

# windows腳本
@echo off
rem create by NettQun
  
rem 這里寫你的倉庫路徑
set REPOSITORY_PATH=D:\Java\maven-repository\maven-aliyun\repository
rem 正在搜索...
for /f "delims=" %%i in ('dir /b /s "%REPOSITORY_PATH%\*lastUpdated*"') do (
    echo %%i
    del /s /q "%%i"
)
rem 搜索完畢
pause

maven 依賴沖突，引用錯(cuò)誤

前兩個(gè)問題主要跟本地網(wǎng)絡(luò)有比較大的關(guān)系，那這個(gè)問題，主要是因?yàn)?maven 特性導(dǎo)致。

那 maven 有一個(gè)依賴傳遞的特性，如果 A 依賴 B，而 B 依賴 C，那么 C 這個(gè)依賴就會(huì)通過 B 間接傳遞給 A。

那如果有多個(gè)間接依賴存在，但是彼此版本卻不一樣，這就會(huì)導(dǎo)致依賴沖突。

如上所示，如果 A 應(yīng)用 使用了 E2.0 新增某些類或者方法，那這個(gè)時(shí)候由于依賴沖突，A 實(shí)際上間接依賴的是 E1.0，這就導(dǎo)致 IDEA 編譯的時(shí)候找不到 E 新增這些類或方法。

那這個(gè)問題解決辦法，也比較簡單，有沖突，我們就直接解決沖突就可以了。

我們可以在 IDEA 中安裝一個(gè) Maven Helper 插件，然后打開 pom 文件，點(diǎn)擊 Dependency Analyzer 選項(xiàng)，在這里面選中 Conflicts 按鈕，就可以看到當(dāng)前所有沖突的依賴包。

選中其中一個(gè)依賴包，就可以在右側(cè)看到所有沖突依賴包的版本。選中其中一個(gè)版本，右鍵選中 Exclude 即可。

上面的辦法我們通過排除其他間接依賴從而解決問題。那下面還有一種解決辦法，將間接依賴轉(zhuǎn)化為直接依賴。

我們可以把間接依賴直接寫在項(xiàng)目 pom 文件里，這樣 maven 將會(huì)直接使用這個(gè)依賴，其他間接依賴將會(huì)失效。

maven 間接依賴異常

這個(gè)問題，就比較詭異，這也是文章剛開頭提到那個(gè)問題。

項(xiàng)目中依賴關(guān)系如下所示。

A 應(yīng)用依賴 B ，那 B 是一個(gè)開源項(xiàng)目，但是公司內(nèi)部對(duì) B 進(jìn)行一些修改。修改之后， B 依賴 C ，所以 A 中使用 C 依賴某些類。

那由于我本地倉庫已經(jīng)下載了 B 開源版本，那當(dāng)我本地拉取 A 應(yīng)用源碼，那依賴關(guān)系就變成了 圖中虛線關(guān)系。

IDEA 缺失了 C 依賴，這就導(dǎo)致項(xiàng)目編譯錯(cuò)誤，無法找到 C 中一些類。

那這個(gè)問題解決辦法，就是在本地倉庫找到 B 依賴，然后刪除拉取即可。

解決辦法比較簡單，關(guān)鍵我們需要找到中間這個(gè)依賴。

IDEA 本地緩存異常

最后一種情況，跟 IDEA 有比較大關(guān)系。

IDEA 之所以快，那是因?yàn)?IDEA 打開新的工程的時(shí)候，它會(huì)構(gòu)建項(xiàng)目索引以及生成相關(guān)緩存。

那有時(shí)候，如果 IDEA 緩存被破壞，那就有可能導(dǎo)致 IDEA 無法識(shí)別 maven 依賴， 從而導(dǎo)致 IDEA 無法找到某些類。

這種情況我們需要?jiǎng)h除原先的緩存以及索引，等待 IDEA 重新構(gòu)建緩存以及索引即可。

在 IDEA 中點(diǎn)擊 File/Invalidate Cached 即可。

最后

如果你如果碰到新的情況，以上幾種解決辦法都沒辦法解決，那么只能使用終極解決辦法。

重啟大法，重啟 IDEA，重啟電腦