SVN 提交報錯「工作副本已崩潰」：原因分析與三步修復指南

錯誤現象

SVN 提交時提示錯誤，錯誤截圖顯示工作副本元數據損壞，典型提示為「Working copy locked」或「sqlite: database disk image is malformed」。

根本原因

.svn 目錄下的 SQLite 數據庫文件（wc.db）損壞，常見誘因：

• 強制終止 SVN 操作（Ctrl+C、殺進程、斷電）
• 磁盤壞道或文件系統錯誤
• 殺毒軟體/索引服務鎖定 .svn 文件導致寫入衝突
• 多個 SVN 客戶端（命令行、TortoiseSVN、IDE 插件）同時操作同一工作副本

三步修復方案（按成功率排序）

步驟 1：執行「清理」命令（首選，無損）

# 命令行
svn cleanup /path/to/working-copy

# TortoiseSVN：右鍵目錄 → TortoiseSVN → Clean up... → 勾選所有選項 → OK

此操作會嘗試修復 wc.db 中的鎖狀態、未完成的操作隊列。

步驟 2：刪除 .svn 目錄並重新 Checkout（徹底，需重新下載）

1. 備份工作副本中已修改但未提交的文件（複製到臨時目錄）
2. 刪除整個工作副本目錄（包含 .svn）
3. 重新 svn checkout 或 TortoiseSVN 「SVN Checkout」
4. 將備份的修改文件覆蓋回新工作副本
5. 執行提交

步驟 3：使用 svnadmin recover 修復服務端倉庫（極少數情況）

若多個開發者同一倉庫同時遇到類似錯誤，可能是服務端倉庫損壞：

# 在 SVN 服務器上執行（需管理員權限）
svnadmin recover /path/to/repository

預防最佳實踐

避坑指南

• 不要手動編輯 .svn 目錄下的文件，任何手動修改都可能導致元數據不一致
• 不要在資源管理器中複製/移動包含 .svn 的目錄，應使用 SVN 客戶端的「SVN Copy/Rename」功能
• 遇到「E155036: Working copy locked」先試 svn cleanup，不行再重新 Checkout

總結

SVN 工作副本崩潰本質是本地元數據庫損壞，90% 以上情況通過 Cleanup 或重新 Checkout 即可解決。養成「小步提交、單一客戶端、排除殺毒掃描」習慣可大幅降低發生概率。