悲劇!IDEA 突然找不到類了?


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

我們本地使用 IDEA 運行 maven 項目的時候,有時候運氣不好,就會遇到某些 maven 依賴無法正常找到、導入。這就會導致 IDEA  構建項目的時候爆出一堆醒目的紅色 Error。

圖片來自網絡

那最近小黑哥新拉取一個項目源碼,本地運行項目,又碰到這種情況。按照以前的解決經驗,搗鼓了一下,發現沒辦法解決。於是研究了一下午,終於解決這個問題🤔。

吐槽一下,剛開始一度以爲是這個項目有問題,找了一個同事,發現他的電腦是卻可以正常運行這個項目。

tempImage1626134851163

那今天這篇的文章,總結一下 IDEA 運行 maven 項目找不到相關依賴報錯的問題原因以及解決辦法。

網絡問題,無法下載 maven 依賴

Maven 默認的中央倉庫地址爲 http://search.maven.org/#browse,那這是一個外網的地址。

而我們國內訪問外網地址,網絡速度不僅慢,網絡質量還差。這就導致了maven 依賴下載速度過慢,有時候下載還可能會失敗。

maven 依賴下載失敗,這就會導致 IDEA 找不到相關依賴。

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

打開我們本地 maven 配置文件,默認地址如下:${user.home}/.m2/settings.xml,然後找到 mirrors節點,在這下面添加以下配置:

<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 文件導致依賴無法正常導入

當你更新鏡像地址之後,有可能還會碰到 maven 依賴無法導入,那恭喜你碰到第二個問題了。

maven 依賴下載的時候,如果碰到網絡較差,依賴下載失敗,maven 本地將會生成 lastUpdated 爲後綴的文件。

img

那正常的 maven 依賴如下

lastUpdated 爲後綴的文件作用如下:

只要 lastUpdated 文件存在,maven 依賴將不會重新下載,所以做簡單的方法就是,刪除 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 依賴衝突,引用錯誤

前兩個問題主要跟本地網絡有比較大的關係,那這個問題,主要是因爲 maven 特性導致。

那 maven 有一個依賴傳遞的特性,如果 A 依賴 B,而 B 依賴 C,那麼 C 這個依賴就會通過 B 間接傳遞給 A。

那如果有多個間接依賴存在,但是彼此版本卻不一樣,這就會導致依賴衝突

如上所示,如果 A 應用 使用了 E2.0 新增某些類或者方法,那這個時候由於依賴衝突,A 實際上間接依賴的是 E1.0,這就導致 IDEA 編譯的時候找不到 E 新增這些類或方法。

那這個問題解決辦法,也比較簡單,有衝突,我們就直接解決衝突就可以了。

我們可以在 IDEA 中安裝一個 Maven Helper 插件,然後打開 pom 文件,點擊 Dependency Analyzer 選項,在這裏面選中 Conflicts 按鈕,就可以看到當前所有衝突的依賴包。

選中其中一個依賴包,就可以在右側看到所有衝突依賴包的版本。選中其中一個版本,右鍵選中 Exclude 即可。

上面的辦法我們通過排除其他間接依賴從而解決問題。那下面還有一種解決辦法,將間接依賴轉化爲直接依賴。

我們可以把間接依賴直接寫在項目 pom 文件裏,這樣 maven 將會直接使用這個依賴,其他間接依賴將會失效。

maven 間接依賴異常

這個問題,就比較詭異,這也是文章剛開頭提到那個問題。

項目中依賴關係如下所示。

A 應用依賴 B ,那 B 是一個開源項目,但是公司內部對 B 進行一些修改。修改之後, B 依賴 C ,所以 A 中使用 C 依賴某些類。

那由於我本地倉庫已經下載了 B 開源版本,那當我本地拉取 A 應用源碼,那依賴關係就變成了 圖中虛線關係。

IDEA 缺失了 C 依賴,這就導致項目編譯錯誤,無法找到 C 中一些類。

那這個問題解決辦法,就是在本地倉庫找到 B 依賴,然後刪除拉取即可。

解決辦法比較簡單,關鍵我們需要找到中間這個依賴。

IDEA 本地緩存異常

最後一種情況,跟 IDEA 有比較大關係。

IDEA 之所以快,那是因爲 IDEA 打開新的工程的時候,它會構建項目索引以及生成相關緩存。

那有時候,如果 IDEA 緩存被破壞,那就有可能導致 IDEA 無法識別 maven 依賴, 從而導致 IDEA 無法找到某些類。

這種情況我們需要刪除原先的緩存以及索引,等待 IDEA 重新構建緩存以及索引即可。

在 IDEA 中點擊 File/Invalidate Cached 即可。

最後

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

重啓大法,重啓 IDEA,重啓電腦




本文分享自微信公衆號 - 程序通事(US_stocks)。
如有侵權,請聯繫 [email protected] 刪除。
本文參與“OSC源創計劃”,歡迎正在閱讀的你也加入,一起分享。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章