Eclipse SVN 鎖定衝突解決全攻略：清理失敗、強制解鎖、權限配置與中文路徑避坑

常見鎖定衝突場景

• 操作中斷（強制關閉 Eclipse、網絡斷開、進程崩潰）導致僵死鎖
• 多用戶並發操作同一文件/目錄
• 清理失敗報錯 is not a working copy directory
• 提交時提示「路徑已被鎖定」或「無權編輯根目錄」

Eclipse 圖形界面解鎖步驟（最直觀）

1. 右鍵項目/文件夾 → Team → Cleanup
2. 若 Cleanup 失敗：右鍵 → Team → Lock → 勾選 Force (強制鎖定) → 確定
3. 再次右鍵 → Team → Unlock

核心邏輯：先強制獲取鎖所有權，再釋放。若直接 Unlock 會提示「非鎖持有者無法解鎖」。

Cleanup 失敗終極方案：剪切法

# 現象：Cleanup 報 "is not a working copy directory"
# 原因：.svn 元數據損壞或目錄結構不一致

# 步驟：
1. 將報錯目錄（如 target/classes）剪切到項目外部備份
2. 右鍵項目 → Team → Cleanup（此時應成功）
3. 提交刪除操作
4. 將備份目錄粘貼回原位（不加入版本控制）
5. Team → Add to svn:ignore（可選）

適用於編譯輸出目錄、生成文件等本不應提交的內容。

SVN 服務端權限配置詳解

svnserve.conf 核心配置

[general]
# 匿名用戶訪問權限：none/read/write
anon-access = none
# 認證用戶訪問權限
auth-access = write
# 密碼文件
password-db = passwd
# 權限文件
authz-db = authz
# 域名
realm = My Repository

authz 精細權限控制

[groups]
admins = admin1, admin2
devs = dev1, dev2
guests = guest1

[/]
@admins = rw
@devs = rw
* = r          # 關鍵：允許匿名讀取根目錄，否則 Checkout 失敗

[/project/trunk]
@devs = rw
@guests = r

[/project/tags]
@admins = rw
@devs = r      # 標籤只讀
* =

關鍵規則：

• 權限繼承：子目錄繼承父目錄權限，顯式配置覆蓋繼承
• * = 明確拒絕：防止未授權用戶通過繼承獲得權限
• SVN 1.3.2+ 支持無父目錄讀權限直接操作子目錄

中文路徑編碼避坑

現象：提交 authz 報錯 section header expected

原因：文件保存為 UTF-8 with BOM，SVN 解析失敗

解決：使用支持「UTF-8 無 BOM」的編輯器保存：

• Notepad++：編碼 → 轉為 UTF-8 (無 BOM)
• UltraEdit：另存為 → UTF-8 - 無 BOM
• EditPlus：文件 → 編碼 → UTF-8 無簽名
• VS Code：右下角編碼點擊 → Save with Encoding → UTF-8

命令行強制解鎖（服務端/無 GUI 環境）

# 查看鎖信息
svn status -u | grep '^L'

# 強制解鎖（需倉庫管理員權限）
svn unlock --force URL/PATH

# 或直接刪除倉庫鎖文件（謹慎操作）
rm /path/to/repo/db/locks/xxx.lock

預防最佳實踐

1. 不要提交 target/.class/.idea 等生成文件：配置全局 svn:ignore
2. 操作前更新：減少衝突與鎖競爭
3. 大文件用 LFS：避免長時間佔用鎖
4. 定期 Cleanup：養成習慣，尤其是異常中斷後
5. 權限最小化原則：按項目/模塊分配讀寫權限

掌握 SVN 鎖機制與權限體系，能讓團隊協作更順暢，避免因元數據損壞導致的數據風險。