Struts 2 登錄實戰教程：從環境搭建到常見坑點避雷

Struts 2 作為經典的 MVC 框架，雖然在新項目中較少使用，但在維護老項目時仍不可避免。本文記錄完整的開發環境搭建、登錄功能實現，並總結實戰中遇到的高頻 404 錯誤及解決方案。

一、開發環境搭建

1.1 核心依賴包

Struts 2.2+ 所需 JAR 包（放入 WEB-INF/lib 或配置 Build Path）：

• commons-fileupload-1.2.1.jar
• commons-io-1.3.2.jar
• commons-logging-1.0.4.jar
• commons-lang3-3.1.jar
• freemarker-2.3.16.jar
• javassist-3.7.ga.jar
• ognl-3.0.jar
• struts2-core-2.2.1.1.jar
• xwork-core-2.2.1.1.jar

1.2 web.xml 配置核心過濾器

<filter>
  <filter-name>struts2</filter-name>
  <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
<filter-mapping>
  <filter-name>struts2</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

注意：Struts 2.3+ 版本 filter-class 可能為 org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter，請根據實際版本調整。

1.3 struts.xml 基礎配置

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
  "https://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
  <package name="main" extends="struts-default">
    <!-- Action 配置將在這裡編寫 -->
  </package>
</struts>

文件必須放在 src 目錄下，命名為 struts.xml（小寫）。

二、登錄功能實現

2.1 JSP 登錄頁面

<form action="<%=request.getContextPath()%>/login" method="post">
  賬號: <input type="text" name="username" /><br/>
  密碼: <input type="password" name="userpwd" /><br/>
  <input type="submit" value="提交"/>
</form>

使用 request.getContextPath() 解決相對路徑問題，確保表單提交地址正確。

2.2 Action 類開發

package com.weiyang.action;

import com.opensymphony.xwork2.ActionSupport;

public class LoginAction extends ActionSupport {
    private String username;
    private String userpwd;

    // Getter/Setter 省略...

    @Override
    public String execute() {
        if ("admin".equalsIgnoreCase(username) && "123456".equalsIgnoreCase(userpwd)) {
            return SUCCESS;
        }
        return ERROR;
    }
}

關鍵點：屬性名（username、userpwd）必須與 JSP 表單 name 屬性完全一致，Struts 2 通過反射自動注入。

2.3 struts.xml Action 映射

<action name="login" class="com.weiyang.action.LoginAction">
  <result name="success">/WEB-INF/success.jsp</result>
  <result name="error">/WEB-INF/error.jsp</result>
</action>

result 路徑建議使用絕對路徑（以 / 開頭），避免因 JSP 所在目錄不同導致跳轉失敗。

三、高頻 404 錯誤排查清單

四、模塊化配置最佳實踐

隨著功能增長，建議按業務模塊拆分配置：

<!-- struts.xml -->
<include file="login.xml"/>
<include file="user.xml"/>
<include file="product.xml"/>

每個子配置文件保持相同的 DTD 聲明與 <struts> 根元素，package name 應唯一且語義化。

五、執行流程總結

1. 用戶訪問 index.jsp，提交表單到 /login
2. web.xml 中的 StrutsPrepareAndExecuteFilter 攔截請求
3. 根據 struts.xml 找到 name="login" 的 Action 配置
4. 實例化 LoginAction，自動注入表單參數
5. 執行 execute() 方法，返回 SUCCESS 或 ERROR
6. 根據返回值跳轉至對應的 result 頁面