Eclipse 中 Java 文件運行報 404：Web 項目結構與部署路徑檢查

問題現象

Eclipse Web 項目中，JSP 文件可正常訪問，但新建的 Java 文件（Servlet/類）運行報 404 錯誤。

404 本質

HTTP 404 表示服務器找不到請求的資源。對於 Java 文件，通常意味著：

• Servlet 未正確映射到 URL 路徑。
• 類未被編譯到 WEB-INF/classes 或打包到 WEB-INF/lib。
• 訪問的 URL 與 @WebServlet 或 web.xml 配置的路徑不匹配。

排查清單

1. 確認 Java 文件類型與用途

• 是 Servlet？需繼承 HttpServlet 並配置 URL 映射。
• 是 普通工具類/Service/DAO？不直接對應 URL，需由 Servlet/Controller 調用。
• 是 JSP 對應的 JavaBean？需放在正確包路徑，JSP 中 useBean 引用。

2. Servlet 映射檢查

// 方式一：注解（Servlet 3.0+）
@WebServlet("/user/login")
public class LoginServlet extends HttpServlet { ... }

// 方式二：web.xml

    LoginServlet
    com.example.LoginServlet


    LoginServlet
    /user/login

訪問 URL 必須為：https://localhost:8080/項目名/user/login

3. 部署結構驗證

• 項目右鍵 → Properties → Deployment Assembly，確認源碼目錄映射到 WEB-INF/classes。
• Server 視圖 → 雙擊 Tomcat → Modules 標簽，確認項目 Path 為 /項目名。
• 清理項目：Project → Clean → 清理選中項目；Tomcat → Clean → Clean Work Directory。

4. 常見新手錯誤

快速驗證步驟

1. 在 Servlet doGet 中寫死 response.getWriter().write("OK")。
2. 瀏覽器訪問映射 URL，若顯示 "OK" 則部署正常。
3. 若仍 404，檢查 Console 是否有 ClassNotFoundException 或映射衝突日誌。

理解「Java 類 ≠ 直接可訪問 URL」，必須通過 Servlet/Controller 映射暴露端點，是 Web 開發入門的關鍵認知轉變。