Maven Web 專案結構詳解與 Java 開發常見問題彙總

前言

從傳統 Web 專案遷移至 Maven 結構時，開發者常對目錄佈局、部署機制、環境變數配置等產生疑惑。本文系統整理 Maven Web 專案標準結構，並針對 Windows 環境變數、命令行編譯執行、Eclipse 依賴管理、Tomcat 部署 Jar 包丟失等高頻問題給出深度解析與最佳實踐。

一、Windows 環境變數：Path vs ClassPath

1. Path 變數 —— 作業系統的命令搜尋路徑

當在 CMD 中輸入 `java`、`javac` 等命令時，作業系統會依序在當前目錄及 Path 指定的目錄下尋找對應的可執行檔（`.exe`）。配置 `%JAVA_HOME%\bin` 到 Path，即可在任意目錄直接執行 JDK 工具命令。

核心作用：簡化命令輸入，讓系統知道去哪裡找可執行程式。

2. ClassPath 變數 —— Java 編譯器/運行時的類搜尋路徑

Java 編譯器（`javac`）與運行時（`java`）需要知道去哪裡載入 `.class` 檔案或第三方庫。ClassPath 指定了用戶類與系統類的搜尋路徑（目錄、JAR、ZIP）。

核心區別：Path 給 OS 用（找 exe）；ClassPath 給 JVM 用（找 class/jar）。

3. 實戰案例

// Test.java
package com.cnblog;
import undact.utils.GetTime;
public class Test {
    public static void main(String[] args) {
        System.out.println(GetTime.GetNowTime());
    }
}

• 編譯：`javac Test.java` 需在 ClassPath 找到 `undact.utils.GetTime`。
• 執行：`java com.cnblog.Test` 必須在**包的上一級目錄**（即含 `com` 目錄的父目錄）執行，否則報「找不到主類」。

二、Maven Web 專案標準結構解析

1. 目錄佈局對比

2. 為何 Eclipse 看起來不同，部署後卻相同？

關鍵在於 **Eclipse 部署組裝配置**（Deployment Assembly）。

• Maven 專案：`src/main/java` → `WEB-INF/classes`；`Maven Dependencies` → `WEB-INF/lib`。
• 傳統專案：`src` → `WEB-INF/classes`；`WebContent` → 應用根目錄；`WebContent/WEB-INF/lib` → `WEB-INF/lib`。

Eclipse 根據這份映射關係，在發布時將專案資源「組裝」成標準 Servlet 容器識別的 Web 應用結構。理解此機制，即可輕鬆在兩種結構間轉換經驗。

三、Eclipse 專案添加 JAR 包的兩種方式

最佳實踐：專案根目錄建立 `lib` 資料夾，放入所有第三方 JAR，使用 Add JARs 引入。Maven 專案則直接透過 `pom.xml` 管理依賴，無需手動操作。

四、Eclipse 發布到 Tomcat 導致 JAR 包丟失的根因

• 現象：運行時 `ClassNotFoundException` 或 `NoClassDefFoundError`，明明 Build Path 有該 JAR。
• 原因：使用 **Add External JARs** 引入的 JAR，**不會被部署組裝配置複製到 `WEB-INF/lib`** 中。
• 解決：改用 `lib` 目錄 + `Add JARs`，或遷移至 Maven 依賴管理（`Maven Dependencies` 自動映射到 `WEB-INF/lib`）。

五、總結建議

1. 拥抱 Maven：統一構建、依賴管理、專案結構，消除「在我機器上正常」的環境差異。
2. 理解部署組裝：掌握 Eclipse Deployment Assembly 映射規則，心中有數才能快速定位部署問題。
3. 規範依賴管理：拒絕 `Add External JARs`，專案內 `lib` 或 Maven 坐標二選一。
4. 環境變數極簡原則：只配 `JAVA_HOME`、`Path`（含 `%JAVA_HOME%\bin`），**不建議設定系統級 ClassPath**，避免污染全局環境，改用專案級/構建工具管理類路徑。