Java Web 項目 "This project needs to migrate WTP metadata" 錯誤一鍵修復

Java Web 項目頻繁提示 This project needs to migrate WTP metadata 錯誤標記，影響構建與部署。根因為 WTP (Web Tools Platform) 元數據版本不匹配或損壞。

即時解決方案

1. 右鍵項目 → Validate
2. 等待驗證完成，錯誤標記自動消失

原理說明

Validate 操作會觸發 WTP 元數據遷移與一致性檢查，自動修復 facet 版本、部署描述符等配置不一致問題。屬於 IDE 級別的元數據同步操作，不修改源代碼。

預防建議

• 團隊統一 Eclipse 版本與 WTP 插件版本
• 避免跨大版本 IDE 直接打開舊項目
• 版本控制忽略 .settings/org.eclipse.wst.common.* 等機器相關配置

此問題純屬 IDE 元數據層面，不影響運行時行為，Validate 一鍵修復即可。