Eclipse Maven 插件依賴搜尋無結果？一鍵啟用 Full Index 徹底解決

問題現象

在 Eclipse 中編輯 pom.xml 時，點選「Add Dependency」搜尋框輸入關鍵字（如 spring-boot），結果列表長期顯示「No matches found」或空白，導致無法透過圖形介面快速新增依賴，只能手動複製 XML 片段。

根因分析

Eclipse Maven 插件 (m2e) 預設不會自動下載中央倉庫索引。索引檔約 100-200 MB，包含所有 artifact 的 groupId、artifactId、version 元資料，搜尋功能強依賴此本地索引。

三步驟徹底修復

步驟 1：啟用啟動時自動更新索引

1. Window → Preferences → Maven
2. 勾選 Download repository index updates on startup
3. Apply and Close

步驟 2：開啟 Maven Repositories 視圖



1. Window → Show View → Other → Maven → Maven Repositories
2. 展開 Global Repositories → central

步驟 3：啟用完整索引並等待下載



1. 右鍵 central 儲存庫 → 選擇 Full Index Enabled
2. 狀態欄會顯示下載進度（約 100-200 MB，視網速 5-30 分鐘）
3. 下載完成後自動建立索引，搜尋功能即時生效

驗證修復



重新開啟 pom.xml → Dependencies 分頁 → Add... → 輸入 spring-boot-starter-web → 應顯示完整版本列表。

進階技巧與避坑

場景	解決方案
企業內網無法連外	配置 settings.xml <mirror> 指向內部 Nexus，同步中央索引至私服
索引損壞/異常	右鍵 central → Rebuild Index 或刪除 ~/.m2/repository/.cache 重來
多儲存庫管理	對每個啟用的 Remote Repository 都執行 Full Index Enabled
離線環境	從有網機器複製 ~/.m2/repository/.cache/m2e/ 目錄

命令列替代方案

若急需新增依賴不想等索引，可直接編輯 pom.xml 或使用命令列：

# 搜尋 artifact (需網路)
mvn dependency:search -DsearchTerm=spring-boot

# 或使用線上搜尋網站
# https://mvnrepository.com / https://search.maven.org

原理補充

• 索引檔實為 Lucene 倒排索引
• m2e 啟動時讀取 ~/.m2/repository/.cache/m2e/ 下的索引段
• Full Index Enabled 觸發下載 nexus-maven-repository-index.gz 並解壓建立