1. SVN仓库目录迁移与降级实战背景
最近在整理公司代码仓库时遇到一个典型场景：原SVN仓库根目录下存在多个平级项目，随着业务发展需要将其中一个核心项目提升为独立仓库，同时把其他附属项目降级为该项目的子目录。这种"仓库降级"操作在SVN中并不常见，但确实是企业代码库重构过程中的真实需求。
我花了三天时间踩遍所有坑，最终总结出这套可靠方案。相比网上零散的svnadmin dump/load方案，本文会重点解决三个核心痛点：
- 如何保持完整版本历史记录
- 如何处理特殊文件属性（如svn:externals）
- 迁移后的权限继承问题
关键提示：操作前务必对原仓库进行完整备份，建议使用
svnadmin hotcopy命令创建热备份
2. 迁移方案设计与工具选型
2.1 方案对比分析
| 方案 | 保留历史 | 处理属性 | 权限继承 | 复杂度 |
|---|---|---|---|---|
| svnadmin dump/load | ✔️ | ❌ | ❌ | 中 |
| svndumpfilter | ✔️ | ✔️ | ❌ | 高 |
| svn mv + 提交 | ❌ | ✔️ | ✔️ | 低 |
| 本方案(svnrdump) | ✔️ | ✔️ | ✔️ | 中高 |
最终选择基于svnrdump的方案，原因在于：
- 支持远程操作（无需服务器权限）
- 可精确过滤路径（比svndumpfilter更灵活）
- 保留所有元数据（包括但不限于svn:externals）
2.2 必要工具准备
# CentOS环境示例 yum install -y subversion svnkit perl-XML-Parser wget https://repo1.maven.org/maven2/org/tmatesoft/svnkit/svnkit/1.10.1/svnkit-1.10.1.jar -O /usr/local/bin/svnkit.jar3. 详细迁移操作步骤
3.1 源仓库结构分析
假设原仓库结构如下：
/ ├── projectA/ # 需保留为主项目 ├── libs/ # 需降级为projectA的子目录 └── docs/ # 需降级为projectA的子目录3.2 分步执行流程
- 创建目标仓库
svnadmin create /svn/newrepo chown -R apache:apache /svn/newrepo # 根据实际web服务器用户调整- 导出projectA完整历史
svnrdump dump http://svn.example.com/svn/oldrepo/projectA \ --username=admin --password=123456 \ > projectA.dump- 导出需降级目录的历史（以libs为例）
svnrdump dump http://svn.example.com/svn/oldrepo/libs \ --username=admin --password=123456 \ | perl -pe 's/^Node-path: libs/Node-path: projectA\/libs/' \ > libs.dump- 合并dump文件
cat projectA.dump libs.dump docs.dump > combined.dump- 导入新仓库
svnadmin load /svn/newrepo < combined.dump \ --parent-dir / --ignore-uuid3.3 关键参数解析
--parent-dir /：确保导入到仓库根目录--ignore-uuid：允许不同仓库的UUID合并- perl替换操作：修改节点路径实现目录层级变更
4. 特殊场景处理方案
4.1 外部引用(svn:externals)处理
在dump文件中搜索svn:externals属性：
grep -A 5 'svn:externals' combined.dump需要手动调整外部引用路径，例如：
^/libs/httpclient -> ^/projectA/libs/httpclient4.2 权限继承问题
建议在新仓库中重建权限：
cp /svn/oldrepo/conf/authz /svn/newrepo/conf/ vi /svn/newrepo/conf/authz # 修改所有路径前缀4.3 大仓库优化技巧
对于超过10GB的仓库：
- 使用
--incremental参数分批次dump - 增加Java堆内存：
export JAVA_OPTS="-Xmx4096m" svnrdump dump ...5. 验证与收尾工作
5.1 完整性检查
svnlook tree /svn/newrepo --full-paths svn log -v file:///svn/newrepo/projectA/libs5.2 客户端迁移
更新所有工作副本：
svn switch --relocate \ http://svn.example.com/svn/oldrepo/projectA \ http://svn.example.com/svn/newrepo/projectA6. 常见问题排查
6.1 报错"Malformed dumpfile"
通常是由于：
- dump文件合并时缺少头尾分隔符
- 文件编码问题（建议使用ASCII格式）
解决方案：
echo "" >> projectA.dump # 确保文件末尾有空行 dos2unix *.dump6.2 版本号不连续问题
这是正常现象，因为：
- 不同路径的版本时间线独立
- 最终版本号=max(各路径版本号)
不影响实际使用，如需美化可以：
svnadmin setrevprop /svn/newrepo -r N --revprop svn:date "2023-01-01T00:00:00Z"6.3 Windows环境注意事项
- 使用Git Bash替代CMD
- 安装最新版Perl（ActivePerl或Strawberry Perl）
- 路径替换命令调整为：
sed -i 's/^Node-path: libs/Node-path: projectA\/libs/' libs.dump7. 进阶优化建议
- 钩子脚本迁移：复制
/svn/oldrepo/hooks/下必要脚本 - 存储优化：迁移后执行
svnadmin pack - 自动化方案：编写Python脚本处理多目录批量迁移
我在实际迁移中发现的几个关键点：
- 凌晨操作速度提升30%（无其他SVN操作干扰）
- 对于包含大量二进制文件的仓库，建议先执行
svn cleanup - 迁移后的第一次commit会较慢，属正常现象
这套方案已成功应用于我们200GB+的代码仓库迁移，累计节省了约40小时的手动调整时间。如果遇到特殊问题，可以检查/svn/newrepo/db/current文件中的最新版本号是否与预期一致。
