利用SVN钩子脚本实现代码提交自动同步至WEB目录

SVN钩子脚本在日常运维中是一个非常实用的工具——尤其在多人协作的代码托管场景下，提交后自动同步到Web目录，能彻底告别手动更新或FTP上传的繁琐流程。其核心就是利用post-commit钩子，在每次提交完成、版本库更新后，自动触发检出或更新操作，让代码变更直接落地生产环境。不过，这里头有不少细节容易忽略，比如脚本的权限、执行用户的身份、协议的选取以及同步方式的原子性。下面逐一拆解。

配置 post-commit 钩子触发同步

SVN仓库的hooks/post-commit脚本会在每次成功提交后执行。首先需要确保这个脚本有可执行权限（chmod +x post-commit），同时它是由运行svnserve或Apache的用户（比如www-data、apache或svn）来调用的。如果权限不匹配，轻则报错，重则根本执行不了——很多人在这一步栽跟头。

• 脚本接收两个参数：$1是仓库路径，$2是本次提交的修订版本号（REVISION）
• 推荐使用svn export而非svn checkout/update，因为export不会产生.svn目录，更安全、简洁
• 如果Web目录已经存在工作副本，也可以用svn update，但必须确保该目录是同一仓库的合法工作副本，且对SVN进程可写

同步脚本示例（export方式）

下面是一个精简可靠的post-commit脚本片段（以Linux为例）：

#!/bin/bash
REPOS="$1"
REV="$2"
WEB_PATH="/var/www/myapp"
SVN_URL="file://$REPOS"

# 导出指定版本到临时目录，再原子性替换
TEMP_DIR="/tmp/svn-export-$$"
mkdir -p "$TEMP_DIR"
svn export -r "$REV" "$SVN_URL" "$TEMP_DIR" --force >/dev/null 2>&1

if [ $ -eq 0 ]; then
   rsync -a --delete "$TEMP_DIR/" "$WEB_PATH/"
   rm -rf "$TEMP_DIR"
fi

注意其中的关键点：rsync -a --delete保证目标目录与导出内容完全一致，且使用了临时目录配合原子替换——这样能避免服务短暂不可用或用户读取到不完整的文件。

权限与路径注意事项

常见失败原因多集中在权限和路径上，下面这几个点需要特别留意：

• Web目录（如/var/www/myapp）必须对SVN服务运行用户可写
• 如果SVN是通过HTTP（mod_da v_svn）访问的，钩子中就不能用file://协议，应改用https://或http:// URL，并确保该URL能被服务器自身访问（必要时配置免密认证或使用本地file://）
• 确保svn命令在钩子执行环境中可用——可以通过which svn确认，如果路径不明确，建议指定绝对路径如/usr/bin/svn
• 日志输出建议重定向到文件（例如>/var/log/svn-postcommit.log 2>&1），这对后续排查问题非常有帮助

安全与生产环境建议

直接同步到Web根目录存在一定风险，实际生产环境中建议增加以下防护措施：

• 限制同步范围：在脚本中校验$REV对应提交的路径，比如只同步/trunk/web/，跳过文档或测试目录
• 增加简单的白名单机制：例如仅允许特定分支（trunk）或标签（tags/v*）触发同步
• 避免在钩子中执行chown或chmod这类敏感操作——正确的做法是由Web服务器用户拥有目录，或者用umask来控制新建文件的权限
• 上线前务必在测试环境中验证钩子行为，观察日志及文件一致性，确保万无一失

这套方案本身并不复杂，但容易忽略的细节恰恰是稳定性的关键所在：权限、路径、协议一致性以及原子性更新。只要把这几个点都做到位，就能实现真正的“提交即上线”。