Eclipse 導入專案全報錯？核心排查步驟與解決方案

Eclipse 導入既有專案後出現大量紅叉錯誤，是 Java 開發者常見痛點。本文提供系統性排查清單，從環境配置、建置路徑、專案屬性三大維度快速定位根因。

快速自檢清單（按可能性排序）

1. JDK 配置不一致

• 現象：Unbound classpath container: 'JRE System Library'、語法版本錯誤。
• 修正：Window > Preferences > Java > Installed JREs 確認指向正確 JDK（非 JRE），專案 Properties > Java Build Path > Libraries 移除舊 JRE 容器，重新 Add Library > JRE System Library 選擇 Workspace default。

2. 專案編譯版本與 Compiler 不符

• 檢查：Properties > Java Compiler 勾選 Enable project specific settings，Compiler compliance level 與 JDK 版本一致（如 1.8、11、17）。

3. Maven/Gradle 依賴未解析

• Maven：右鍵專案 Maven > Update Project 勾選 Force Update；或命令列 mvn clean install -U。
• Gradle：Gradle > Refresh Gradle Project；檢查 build.gradle repository 配置。

4. 專案 Facet 版本衝突

• Properties > Project Facets 確認 Dynamic Web Module、Java、JavaScript 版本與伺服器執行環境相容。

5. 原始碼編碼不一致

• Properties > Resource > Text file encoding 設為 UTF-8，避免中文註解亂碼導致編譯錯誤。

進階：Clean 與 Rebuild 大法

// 選單列
Project > Clean... > 選擇專案 > Clean
// 或關閉 "Build Automatically" 後手動 Build

若 Clean 後仍報錯，請檢查 Error Log 視圖 (Window > Show View > Error Log) 獲取完整堆疊追蹤。

常見特定錯誤對應表

終極方案：重新導入

1. 刪除專案（勾選 Delete project contents on disk 取消）。
2. 刪除工作區中 .metadata/.plugins/org.eclipse.core.resources/.projects/專案名。
3. File > Import > Existing Maven/Gradle Projects 重新導入。

系統性排查通常能在 10 分鐘內解決 90% 的導入報錯。養成「先看 Error Log、再查 Build Path、最後 Clean/Reimport」習慣，效率倍增。