Eclipse/IDEA 本地調試 Maven Web 專案：解決依賴 JAR 未部署到伺服器

問題現象

本地啟動 Tomcat/Jetty 調試 Maven Web 專案時，WEB-INF/lib 下缺少 Maven 依賴的 JAR 包，導致 ClassNotFoundException 或 NoClassDefFoundError。

根因

IDE 的部署組裝配置未將 Maven Dependencies（構建路徑庫） 包含進 Web 部署輸出。

解決方案：Deployment Assembly 添加 Maven Dependencies

以 Eclipse 為例（IDEA 同理配置 Artifacts）：

1. 專案右鍵 → Properties → Deployment Assembly
   
2. 點擊 "Add..." → 選擇 "Java Build Path Entries" → Next
   
3. 勾選 "Maven Dependencies" → Finish
   

驗證

• 重新啟動伺服器，查看部署目錄 wtpwebapps/專案名/WEB-INF/lib 是否出現依賴 JAR。
• 或在伺服器視圖右鍵專案 → "Clean" 再 "Publish"。

IDEA 用戶對應操作

1. File → Project Structure → Artifacts
2. 選中 Web 應用輸出布局，Output Layout 標籤下 + → Module Dependencies → 選中 Maven 依賴模組。
3. 確保 WEB-INF/lib 目錄包含所有編譯/運行時依賴。

常見誤區

• ❌ 僅在 pom.xml 加依賴不刷新 IDE 配置。
• ❌ 手動複製 JAR 到 WEB-INF/lib（破壞 Maven 管理）。
• ✅ 正確做法：IDE 部署配置綁定 Maven 依賴容器，實現自動同步。