rsync中怎么在自动化运维脚本中通过解析rsync状态码判定数据是否传输成功-linux运维-PHP中文网

rsync执行后通过状态码判断同步结果：0为完全成功，24/25为软成功（需记录警告），1为命令语法错误（需修复脚本），2/3为硬错误（需告警或重试）。

rsync中怎么在自动化运维脚本中通过解析rsync状态码判定数据是否传输成功

rsync 命令执行完成后会返回一个状态码（exit code），在自动化脚本中通过检查这个状态码，可以准确判断同步是否成功、失败或出现部分异常。关键不是只看是否为 0，而是要理解不同非零码的含义并做差异化处理。

rsync 常见状态码及其含义

rsync 官方文档定义了多个退出状态，实际脚本中重点关注以下几类：

0：成功完成，所有文件都已正确同步，无任何警告或错误
1：语法错误或使用错误（如参数拼写错、缺少必要选项）——属于脚本调用问题，需修复脚本本身
2：无法访问某些文件/目录（如权限不足、路径不存在）——常见于目标端权限问题或源路径误配
3：传输过程中发生 I/O 错误（如磁盘满、网络中断、SSH 连接断开）——最需关注的“运行时失败”
24：部分文件因时间戳/大小未变而被跳过（注意：这是正常行为，不表示失败）
25：某些文件因权限/属主变更失败但其余成功（例如 --chown 失败）——取决于是否容忍此类差异

Shell 脚本中推荐的状态码判断逻辑

不要简单写成 if [ $? -eq 0 ] 就完事。应区分可恢复错误和需告警的严重错误：

状态码为 0 → 认定完全成功，可记录日志或触发后续动作
状态码为 24 或 25 → 视为“软成功”，通常无需中断流程，但建议记录为 warning 级别日志
状态码为 2 或 3 → 属于硬错误，大概率需人工介入，应发送告警、退出脚本或进入重试逻辑
状态码为 1 → 表明脚本存在缺陷（如 rsync 路径写错、变量为空），应直接退出并打印调试信息

实用脚本片段示例

以下是一个简明健壮的判断结构（Bash）：

讯飞智作-讯飞配音

讯飞智作-讯飞配音是一款由科大讯飞推出的 AI 配音和音视频内容生产工具。

下载

rsync -avz --delete /src/ user@host:/dst/
rsync_status=$?
case $rsync_status in
  0)
    echo "[OK] Sync completed successfully"
    ;;
  24|25)
    echo "[WARN] Sync finished with minor issues (e.g. unchanged files or chown skipped)"
    ;;
  1)
    echo "[ERROR] rsync command usage error — check syntax and variables"
    exit 1
    ;;
  2|3)
    echo "[CRITICAL] Sync failed due to access or I/O error — verify paths, permissions, network"
    # 可在此加入告警命令，如 curl 发送企业微信通知
    exit 1
    ;;
  *)
    echo "[UNKNOWN] rsync returned unexpected exit code: $rsync_status"
    exit 1
    ;;
esac