Eclipse SVN 插件常見報錯原因與解決方案彙總

團隊協作中 SVN 插件報錯高發，本文整理實戰中遇到的典型錯誤、根因分析與經驗修復方案，助你快速恢復版本控制正常運作。

錯誤一：Working copy not locked / .svn 目錄遺失

org.tigris.subversion.javahl.ClientException: Working copy not locked
svn: Directory '.../WEB-INF/classes/com/.svn' containing working copy admin area is missing

根因：Eclipse 自動編譯將 src 目錄下的 .svn 元資料複製到 WEB-INF/classes（或 bin），導致輸出目錄出現「殘缺」的工作副本元資料。

解決：在 Java Build Path → Source 標籤 → Excluded 中添加 **/.svn/**，排除編譯輸出。
操作路徑：Project → Properties → Java Build Path → Source → Excluded: **/.svn/**

錯誤二：使用者/密碼變更後認證失敗

現象：更新/提交提示舊憑證錯誤。

解決：刪除本地憑證快取：

• Windows: C:\Users\{user}\AppData\Roaming\Subversion\auth\ 整個目錄刪除；
• 或使用 TortoiseSVN → Settings → Saved Data → Clear Authentication Data。

錯誤三：bin/ 目錄被誤納入版本控制

svn: '.../project/bin/org/.svn' containing working copy admin area is missing

根因：bin（編譯輸出目錄）不應受版本控制。

徹底清理步驟：

1. 專案右鍵 → Team → Set Property → 名稱 svn:ignore 值 bin；
2. 倉庫瀏覽器中刪除 bin 目錄；
3. 本地刪除 bin/.svn 後 Update，再 Clean/Build 專案。

錯誤四：/WEB-INF/ 目錄下 .svn 被發布刪除

現象：Tomcat 熱部署清理目錄時連帶刪除 .svn，導致同步報錯。

解決：倉庫瀏覽器刪除對應 /WEB-INF/ 子目錄，本地 Refresh 再同步；或配置發布排除 .svn。

預防清單

• ✅ 專案建立即配置 svn:ignore 忽略 bin、target、.classpath、.project、.settings。
• ✅ Build Path 排除 **/.svn/**。
• ✅ 使用 svn:externals 管理共用庫，避免巢狀工作副本。
• ✅ 定期 svn cleanup 修復鎖殘留。