Eclipse ESftp 插件導致卡死的排查與解決思路

現象回顧

• 環境：Eclipse for PHP + ESftp 插件，用於上傳文件到 Linux。
• 觸發：連續按鍵同時上傳、編譯導致 Eclipse 假死一次後，後續只要啟用該插件 Eclipse 就卡死，關閉也無法正常退出。
• 已嘗試：重裝 Eclipse、清理插件相關文件/註冊表、-clean 啟動、換其他 Eclipse 版本（非 PHP 版正常）、查看日誌無異常。

問題定位分析

1. 插件與 Eclipse 版本/運行時衝突

ESftp 可能依賴特定 Eclipse 平台版本或 PHP 開發工具 (PDT) 的內部 API。PHP 版 Eclipse 的插件組合與其他版本不同，可能導致類加載衝突或死鎖。

2. 插件內部狀態損壞

首次假死可能導致插件的持久化狀態（工作區 .metadata/.plugins 下的插件數據）損壞，後續啟動時讀取損壞數據進入死循環。

3. SSH/JSch 底層連接未正確釋放

ESftp 底層通常用 JSch 實現 SFTP。若上傳線程被強制中斷，Session/Channel 未正確關閉，可能殘留佔用資源或鎖，導致後續操作卡住。

建議排查步驟

1. 清理工作區插件狀態：刪除工作區 .metadata/.plugins/org.eclipse.core.runtime/.settings/ 下 ESftp 相關 .prefs 文件，或嘗試新建工作區導入專案。
2. 啟用詳細日誌：在 eclipse.ini 添加 -debug 或設置 org.eclipse.equinox.p2.core/reconciler=true，查看 .metadata/.log 中是否有 Deadlock、Timeout、ClassCastException 等線索。
3. 隔離測試：在乾淨的 Eclipse (PHP 版) 中僅安裝 ESftp，不裝其他第三方插件，驗證是否仍複現。若正常，則為插件間衝突。
4. 替換方案：若無法根治，建議改用成熟替代品：
   • Remote System Explorer (RSE)：Eclipse 官方內建，支援 SFTP/FTP/SSH 終端，穩定性高。
   • External Tools 配置 WinSCP/FileZilla：外部工具整合，完全避開插件進程。
   • VS Code + SFTP 擴展：現代編輯器體驗更佳。

深入研究資源

若需深入理解 Eclipse 插件機制（OSGi、Equinox），可參考：IBM developerWorks: Eclipse OSGi 專題

圖片參考

總結

ESftp 在特定 Eclipse PHP 環境下導致卡死，多為插件狀態損壞或與 PDT 衝突。優先清理工作區插件數據、啟用詳細日誌定位；若業務允許，強烈建議遷移至 RSE 或外部工具，獲得更穩定的開發體驗。