Struts2 專案缺少 JAR 包與 Javadoc 找不到的解決辦法

Struts2 專案啟動 Tomcat 時提示缺少 JAR 包（如 struts2-core、xwork-core 等），或 IDE 提示 This element has no attached source and the Javadoc could not be found，通常是專案建置路徑缺少依賴、或 Maven 依賴未正確解析。

核心解決步驟

1. 確認 Maven 依賴完整：
   檢查 pom.xml 是否包含 Struts2 核心依賴：
   

   <dependency>
       <groupId>org.apache.struts</groupId>
       <artifactId>struts2-core</artifactId>
       <version>2.5.30</version> <!-- 使用對應版本 -->
   </dependency>

2. Maven 重新導入依賴：
   右鍵專案 → Maven → Update Project → 勾選 Force Update → OK。
   或命令列：mvn clean compile dependency:resolve。
3. 檢查部署組件：
   專案 Properties → Deployment Assembly → 確認 Maven Dependencies 已加入，輸出至 WEB-INF/lib。
4. 解決 Javadoc/Source 缺失提示：
   此為 IDE 警告，不影響運行。若需附上源碼：
   Maven → Download Sources / Download Javadoc。
   或手動在 .m2 倉庫找到對應 -sources.jar/-javadoc.jar 附加至 Library。
5. 檢查類別衝突：
   若自訂類別名稱與 Struts 核心類別重名（如 AbstractInterceptor），會導致編譯/運行錯誤。重新命名自訂類別，避免與框架核心包衝突。

常見缺少的 Struts2 核心 JAR

• struts2-core
• xwork-core
• ognl
• freemarker (若使用標籤)
• commons-fileupload, commons-io (檔案上傳)
• javassist (動態代理)

快速驗證

專案右鍵 → Build Path → Configure Build Path → Libraries → Maven Dependencies 展開，確認上述 JAR 存在且無紅叉。若缺少，執行 mvn dependency:tree 分析傳遞依賴是否被排除。

規範 Maven 依賴管理、避免類別命名衝突，是 Struts2 專案穩定運行的基礎。