Eclipse Maven Web 專案創建失敗：archetype-webapp 索引損壞一鍵修復

錯誤現象

在 Eclipse 中 File → New → Maven Project → maven-archetype-webapp 時，卡在「Resolving Archetype」或彈出「Could not resolve archetype」錯誤。

根因：本地 Archetype 目錄損壞/不完整

Eclipse m2e 插件在 ~/.m2/repository/archetype-catalog.xml 及對應 JAR 快取元資料。網路波動、中斷下載、版本衝突導致快取不一致，無法解析骨架模板。

最暴力有效修復：刪除本地倉庫重建

1. 關閉 Eclipse
2. 刪除 ~/.m2/repository/ 整個目錄 (或僅刪除 org/apache/maven/archetypes/)
3. 啟動 Eclipse
4. 重新創建 Maven Project → 會自動下載最新 archetype-catalog 及模板 JAR

精準修復：僅清理 Archetype 快取

# 1. 刪除 archetype 目錄
rm -rf ~/.m2/repository/org/apache/maven/archetypes/

# 2. 刪除 catalog 快取
rm -f ~/.m2/repository/archetype-catalog.xml

# 3. Eclipse 中刷新
# Window → Preferences → Maven → User Settings → Update Settings → Reindex

進階：手動指定 Archetype 版本

若中央倉庫最新版有問題，可在創建向導中：

1. 勾選 Include snapshot archetypes
2. 手動輸入：
   Group Id: org.apache.maven.archetypes
Artifact Id: maven-archetype-webapp
Version: 1.4 (或穩定版 1.3)

網路受限環境離線創建

# 1. 有網機器預先下載
mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes \
  -DarchetypeArtifactId=maven-archetype-webapp -DarchetypeVersion=1.4 \
  -DgroupId=com.test -DartifactId=demo -DinteractiveMode=false

# 2. 複製 ~/.m2/repository/org/apache/maven/archetypes/ 至離線機器

# 3. Eclipse 離線模式創建
# Preferences → Maven → ☑ Offline → 新建專案選擇本地 archetype

Eclipse 內建 Maven vs 外部 Maven 衝突排查

驗證創建成功標準結構

webapp-demo/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/
│   │   ├── resources/
│   │   └── webapp/
│   │       ├── WEB-INF/
│   │       │   └── web.xml
│   │       └── index.jsp
│   └── test/
│       └── java/
└── target/ (構建後生成)

常見後續問題快速修復

• web.xml 版本過舊：手動升級至 Servlet 3.0+ <web-app version="3.1">
• JSP 編譯錯誤：確認 pom.xml 含 jsp-api (provided) 與 jstl 依賴
• 部署無 WEB-INF/lib：Deployment Assembly 確認 Maven Dependencies → WEB-INF/lib