SVN工作副本被锁或缓存异常本质是本地元数据状态不一致，核心修复分三步：先执行svn cleanup释放锁定；再检查并终止残留SVN或IDE进程；最后在无进程占用时用sqlite3手动重建wc.db数据库。
SVN工作副本被锁或缓存异常，本质是本地元数据状态不一致，不是文件损坏，也不需要重检出。核心思路是分层修复：先用标准命令恢复，再查进程干扰，最后手动干预数据库。
执行标准 cleanup 释放锁定
这是第一响应动作，适用于大多数因中断（如断网、强制关机、IDE卡死）导致的锁死。命令会扫描 .svn 目录下的锁标记（如 wc.db 中的 lock 表、临时 .lock 文件），并安全清除。
- 在工作副本根目录打开终端，直接运行：svn cleanup
- TortoiseSVN 用户：右键 → TortoiseSVN → Clean up → 勾选 “Include externals”（如有外部引用）→ 点击 OK
- 若某子目录清理失败，可进入该目录单独执行 svn cleanup；嵌套较深时，建议从最外层开始逐级清理
检查并终止残留 SVN 或 IDE 进程
当 cleanup 报错 “database is locked” 或反复失败，大概率是 svn 进程未完全退出，仍在占用 wc.db 数据库文件。
- Linux/macOS：运行 ps -ef | grep svn，找到相关 PID 后执行 kill -9 <PID>
- Windows：任务管理器中查找 svn.exe 或 IDE 进程（如 IntelliJ、Eclipse），结束全部相关进程
- 杀完进程后，务必再次运行 svn cleanup —— 此时成功率极高
手动重建 wc.db 消除数据库级损坏
仅当 cleanup 仍失败，且确认无进程占用时启用。原理是用 sqlite3 备份并重建工作副本数据库，跳过损坏的锁记录，不丢失版本信息。
- 进入项目根目录下的 .svn 文件夹：cd /path/to/project/.svn
- 备份原库：mv wc.db wc.db.bak
- 用 sqlite3 创建新库：sqlite3 wc.db ".backup main ../.svn/wc.db.bak"（注意路径指向备份文件）
- 若提示 .backup 命令不存在，说明 sqlite3 版本过低，改用：cp wc.db.bak wc.db（直接覆盖，风险略高但有效）
按需使用 force 和深度参数精准清理
标准 cleanup 不处理“编辑中”或受保护文件。遇到提示 “file is locked, try --force”，说明有状态冲突需强制介入。
- 强制清理所有锁定与异常状态：svn cleanup --force
- 仅清理顶层目录（避免递归影响子模块）：svn cleanup --depth empty
- 连同被 svn:ignore 标记的临时文件一并删除：svn cleanup --remove-ignored
- 静默执行（适合脚本集成）：svn cleanup --quiet
不复杂但容易忽略：清理前关闭所有可能访问该项目的程序（尤其是编辑器、构建工具），清理后立即执行 svn status 验证状态是否清空，再做 update 或 commit。多数锁死问题三步内即可解决。
