AppFuse 1.7 部署配置錯誤修正：ant deploy-web vs ant deploy

問題現象

官方文件指示執行 ant deploy-web 發布至 Tomcat webapps/，實測未複製完整檔案，導致應用啟動失敗（缺少 JSP、資源檔、配置等）。

正確指令

ant deploy

此目標會完整建構 WAR 並部署至 $CATALINA_HOME/webapps/ (Tomcat 5/6) 或 $CATALINA_HOME/conf/Catalina/localhost/ (Tomcat 5+ context XML)。

標準部署流程修正版

1. ant setup-tomcat：複製 MySQL JDBC Driver、jta.jar 至 $CATALINA_HOME/common/lib/，部署 appfuse.xml context 描述符
2. ant deploy：建構並部署完整 WAR（修正點）
3. 啟動 Tomcat
4. ant test-canoo -Dtestcase=Login：驗證登入功能

背景知識

• AppFuse 1.x 基於 Ant 建構，後續版本遷移至 Maven
• deploy-web 可能僅部署 web/ 目錄內容，遺漏 WEB-INF/lib/、classes/ 等
• deploy 依賴 war 目標打包完整 Web 應用結構

遷移建議

AppFuse 2.x/3.x 已全面採用 Maven，建議專案升級至 mvn cargo:deploy 或 CI/CD 流程，避免 Ant 維護成本。

總結

單行修正：將文件第 4 步 ant deploy-web 改為 ant deploy，即可解決部署不完整問題。此類文件滯後於代碼的情況在開源專案常見，實測驗證為第一原則。