Maven 導入項目解決 Dynamic Web Module 版本衝突問題

Maven 導入項目解決 Dynamic Web Module 版本衝突問題

將 Maven Web 項目導入 Eclipse/IDEA 時，常遇到「Cannot change version of project facet Dynamic Web Module to 2.3」錯誤。原因是 web.xml 版本聲明與項目 Facet 設置不一致。

快速修復方案

修改 src/main/webapp/WEB-INF/web.xml 文件頭部聲明，升級至 Servlet 3.0 規範：

<web-app xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" 
         xmlns="https://java.sun.com/xml/ns/javaee" 
         xsi:schemaLocation="https://java.sun.com/xml/ns/javaee 
         https://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
         version="3.0">
    <!-- 原有配置內容 -->
</web-app>

關鍵變更點

1. xmlns="https://java.sun.com/xml/ns/javaee"：聲明 Java EE 命名空間
2. xsi:schemaLocation 指向 web-app_3_0.xsd：對應 Servlet 3.0
3. version="3.0"：明確聲明版本

版本對應關係

IDE 同步步驟

1. 修改 web.xml 保存
2. Eclipse：右鍵項目 → Maven → Update Project → 勾選 Force Update
3. IDEA：右鍵項目 → Maven → Reload Project
4. 檢查 Project Facets：Dynamic Web Module 應顯示 3.0 或更高

根本原因

Maven 項目默認生成的 web.xml 可能是舊版本聲明，而現代 IDE 的 Web Facet 默認版本較高，版本不匹配導致項目識別失敗。統一聲明為項目實際使用的 Servlet 版本即可解決。