Eclipse SVN 插件常見報錯全景解析：.svn 目錄汙染、用戶切換與忽略配置實戰

錯誤 1：Working copy not locked / .svn missing

現象：Update 時提示 svn: Directory '.../WEB-INF/classes/com/.svn' containing working copy admin area is missing

根因：Eclipse 自動編譯將 src 下的 .svn 目錄複製到 WEB-INF/classes，導致元數據不一致。

徹底解決：在 Java Build Path → Source → Excluded 中添加 **/.svn/**

Project → Properties → Java Build Path → Source 選項卡
→ 展開源文件夾 → Excluded: **/.svn/** → Apply

此舉防止 .svn 進入編譯輸出目錄，一勞永逸。

錯誤 2：用戶/密碼切換後認證失敗

現象：Commit/Update 提示舊用戶憑證錯誤。

解決：刪除本地憑證緩存

• Windows: %APPDATA%\Subversion\auth 目錄整個刪除
• TortoiseSVN 安裝環境：右鍵 → Settings → Saved Data → Authentication Data → Clear

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

現象：比對時出現 .../bin/org/.svn ... containing working copy admin area is missing

處理步驟：

1. 右鍵項目 → Team → Set Property → name: svn:ignore value: bin
2. Repository 瀏覽器中刪除 bin 目錄
3. 本地刪除 bin/org 等殘留
4. 右鍵 bin → Update (目錄消失)
5. Project → Clean → Rebuild

錯誤 4：提交後更新報 "Working copy locked"

快速修復：右鍵項目 → Team → Cleanup（執行 svn cleanup）

最佳實踐清單

• 永遠忽略：**/target/**, **/bin/**, **/.classpath, **/.project, **/.settings/**, **/.svn/**
• 使用 svn:externals 管理公共庫，避免重複提交
• 遷移建議：新項目優先選 Git + GitLab/GitHub，SVN 仅維護存量