如何使用SVN钩子脚本将每次提交直接同步到镜像仓库

SVN 本身并不支持“自动推送”到另一个仓库——比如 Git 镜像库。原因很简单，Subversion 是集中式版本控制系统，它压根没有原生的远程同步机制。所以，所谓的“每次提交自动同步到镜像仓库”，实际要靠钩子脚本配合外部工具来实现单向镜像。核心思路是在主 SVN 仓库的 post-commit 钩子里，触发一次导出或转换操作，然后推送到目标 Git 仓库。

确认镜像目标类型

先得搞清楚你要镜像成什么类型：

• Git 仓库（最常见）：用 git-svn 初始化一个 Git 仓库，然后定期拉取 SVN 变更，再推送到远程 Git 平台（比如 GitHub、GitLab）。
• 另一个 SVN 仓库：官方推荐用 svnsync。不过这要求目标库是只读的，而且需要先初始化同步。
• 纯文件备份：直接用 svn export 把最新版本导出到指定目录就行。

大部分场景下，所谓“镜像仓库”指的就是 Git 仓库。下面以这个场景为主来说。

使用 git-svn 建立初始镜像

在服务器上选个工作目录，执行一次初始化（这事儿只做一次）：

# 克隆整个 SVN 仓库（包含所有历史）
git svn clone --stdlayout --prefix=origin/ https://svn.example.com/repo my-mirror

cd my-mirror

# 添加远程 Git 仓库地址（比如 GitHub）
git remote add mirror https://github.com/yourname/mirror.git

# 首次推送所有分支和标签
git push mirror --all
git push mirror --tags

这里需要提一句：--stdlayout 表示 SVN 用的是标准的 trunk/branches/tags 结构。如果你的仓库结构不一样，记得调整参数。

编写 post-commit 钩子自动同步

编辑主 SVN 仓库的 hooks/post-commit 文件（别忘了加上可执行权限），内容大致如下：

#!/bin/bash
REPOS="$1"
REV="$2"

# 镜像工作目录（需提前创建并初始化好 git-svn）
MIRROR_DIR="/path/to/my-mirror"

# 切换到镜像目录，拉取新提交
cd "$MIRROR_DIR" || exit 1
/usr/bin/git svn fetch --quiet

# 将新提交 rebase 到 git 主线（避免产生 merge 提交）
/usr/bin/git rebase origin/trunk

# 推送到远程 Git 仓库
/usr/bin/git push mirror origin/trunk:main --quiet

# （可选）同步 tags 和 branches，需要额外脚本逻辑

这里面有几个关键点得特别注意：

• 钩子里必须用绝对路径调用 git 和 git svn，因为环境变量受限；
• 运行钩子的用户要对 MIRROR_DIR 有读写权限，而且 SSH key 或 HTTPS 凭据得提前配好，不然 push 不了；
• 要小心并发冲突：如果多个提交快速连续进来，git svn fetch 加 rebase 的操作很可能失败。建议加个简单锁，或者写个重试逻辑。

替代方案：用 svnsync 同步到另一个 SVN

如果你的目标仍然是 SVN 仓库，那用 svnsync 会更稳定可靠：

• 目标库必须为空，而且需要启用 pre-revprop-change 钩子（允许修改修订属性）；
• 主库的 post-commit 钩子里调用 svnsync sync file:///path/to/mirror；
• 首次同步需要用 svnsync initialize 建立关联。

相比 git-svn，svnsync 原生支持增量同步、原子性操作和断点续传，做纯 SVN 镜像场景时非常合适。

整个流程其实不复杂，但有些细节容易忽略。钩子执行失败并不会阻断 SVN 提交，但一旦失败，镜像就会滞后或者完全中断。所以一定要把 stdout 和 stderr 重定向到日志文件，先手动测试一次，再持续监控推送结果。这才是保证镜像可靠运行的关键所在。