struts.xml 紅叉:找不到 Action 類、Result 路徑錯誤。struts2-core.jar、ognl.jar、xwork.jar 等核心包。ClassNotFoundException 或 NoClassDefFoundError。WebRoot/WEB-INF/lib 下是否包含 Struts2 全套 jar(核心 + 依賴)。struts2-core, ognl, xwork, freemarker, javassist, commons-logging, commons-fileupload, commons-io。mvn clean compile dependency:copy-dependencies 或在 IDE 點「Maven → Update Project」強制下載依賴。Maven Dependencies 或 WebRoot/WEB-INF/lib 已部署到 WEB-INF/lib。src 根目錄(編譯後在 classes 根),且 <package name="default" namespace="/" extends="struts-default"> 命名空間正確。<action name="login" class="com.example.action.LoginAction"> 的 class 必須與 Java 包名完全一致,大小寫敏感。struts.xml、web.xml、Java 檔、資料庫連線皆為 UTF-8。Project → Clean,刪除 .metadata/.plugins/org.eclipse.wst.server.core 下的伺服器發布資料,重新發布。# 在專案根目錄執行(Maven)
mvn dependency:tree | grep struts
# 應看到 struts2-core 及其傳遞依賴
90% 的「全報錯」都是 **jar 包缺失** 或 **部署路徑未映射** 導致,按清單逐項排查即可解決。