Maven 搭建 Java EE 專案完整圖文教程

開發環境

• JDK 1.7+
• Tomcat 7+
• Eclipse IDE for Java EE (Luna 或更新版)
• Maven 3.2+ (建議使用 Eclipse 內嵌或外部安裝)

步驟 1：建立 Maven Web 專案

1. File → New → Other → Maven Project
2. 勾選 "Create a simple project" → Next
3. 選擇 Archetype: maven-archetype-webapp (若無，可先選 simple 後手動轉換)
4. 輸入 Group Id (如 com.example)、Artifact Id (如 my-webapp)、Version、Package → Finish

步驟 2：修正專案結構為標準 Maven 目錄

預設 webapp 目錄結構不完整，需手動補齊：

src/main/java
src/main/resources
src/test/java
src/test/resources

1. 右鍵專案 → Build Path → Configure Build Path → Source 頁籤 → Remove 紅叉項目。
2. Add Folder → 建立上述四個資料夾並加入。
3. 設定輸出路徑：test 目錄輸出至 target/test-classes。

步驟 3：調整專案 Facets 版本

1. Properties → Project Facets → Java 版本改為 1.7 (或當前 JDK)。
2. Dynamic Web Module 若無法修改，編輯 .settings/org.eclipse.wst.common.project.facet.core.xml，將 jst.web version 改為 3.0 (Servlet 3.0)。
3. 重新整理專案，Facets 顯示更新。

步驟 4：Deployment Assembly 配置

1. Properties → Deployment Assembly
2. Remove 測試相關項目 (src/test/*)
3. Add → Java Build Path Entries → Maven Dependencies → Finish (關鍵：將依賴 jar 部署至 WEB-INF/lib)

步驟 5：pom.xml 核心依賴配置

<properties>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<dependencies>
    <!-- Servlet API (provided 由容器提供) -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <scope>provided</scope>
    </dependency>
    <!-- JSP API -->
    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>javax.servlet.jsp-api</artifactId>
        <version>2.3.1</version>
        <scope>provided</scope>
    </dependency>
    <!-- JSTL -->
    <dependency>
        <groupId>jstl</groupId>
        <artifactId>jstl</artifactId>
        <version>1.2</version>
    </dependency>
    <!-- 測試 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<build>
    <finalName>${project.artifactId}</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <failOnMissingWebXml>false</failOnMissingWebXml> <!-- Servlet 3.0+ 可無 web.xml -->
            </configuration>
        </plugin>
    </plugins>
</build>

步驟 6：更新 Maven 專案與部署

1. 右鍵專案 → Maven → Update Project → 勾選 Force Update → OK
2. Eclipse Servers 視圖新增 Tomcat Server，Add 專案
3. Start Server，瀏覽器訪問 https://localhost:8080/專案名/ 顯示 index.jsp 即成功

常見問題排查

• web.xml 版本與 Servlet 版本不匹配 → 更新 web-app 根元素 version="3.0" 或移除 web.xml 使用註解。
• JSP 編譯錯誤 → 確認 JDK 編譯版本一致、JSP API scope 為 provided。
• 依賴衝突 → mvn dependency:tree 分析，使用 <exclusion> 排除傳遞依賴。