Struts2 最簡單 Demo 卻報 404：排查核心配置與訪問路徑

常見 404 原因清單

1. Action 映射路徑錯誤：struts.xml 中 <action name="helloworld">，訪問應為 /helloworld.action（或配置的後綴）。
2. Result 路徑錯誤：/WEB-INF/page/Hello.jsp 需確保文件存在且路徑正確，WEB-INF 下資源需通過框架轉發訪問。
3. Filter 配置缺失/錯誤：web.xml 中 StrutsPrepareAndExecuteFilter 的 url-pattern 必須為 /* 或 *.action。
4. 包結構不匹配：class="cn.itcast.action.HelloWorldAction" 需與源碼包名一致，編譯後 class 文件在 WEB-INF/classes 下。
5. Tomcat 部署路徑：確認項目上下文路徑（Context Path），訪問 URL 為 https://localhost:8080/項目名/helloworld.action。

快速排查步驟

• 控制台查看啟動日誌，是否有 Struts 初始化錯誤（紅字）。
• 嘗試訪問 https://localhost:8080/項目名/helloworld.action（注意大小寫）。
• 檢查 WEB-INF/classes/cn/itcast/action/HelloWorldAction.class 是否存在。

最佳實踐

使用 Maven 管理依賴，避免 jar 包衝突；採用注解開發（@Action、@Result）減少 XML 配置出錯機率。