备份命令显示成功,为什么文件仍不可用

定时任务返回0,目录里也有压缩包,恢复时却发现没有有效数据。使用 mysqldump ... | gzip 这类管道时,一种常见原因是前面的导出失败,后面的压缩仍然正常结束,脚本只记录了最后一步的状态。

本篇用Bash和GNU gzip做一个不连接数据库、不创建文件的演示,说明怎样识别这种误判。它不是生产备份脚本;已有数据库的实际备份方法见MySQL导出与隔离恢复教程。

宝乐云原创示意图:导出失败而gzip成功时,默认管道退出状态可能误导备份判断
图:管道状态、压缩文件完整性和隔离恢复结果,要分别检查。

为什么导出失败,整条命令还会返回0

Bash默认取管道最后一个命令的退出状态。导出工具因认证失败、权限不足或连接中断而退出时,gzip可能只收到空数据或一部分数据;它仍能把这些输入压成格式正确的压缩流。

因此,“gzip压缩完成”“文件能解压”和“数据库完整导出”是三个不同的判断。只加 set -e 也不足以发现这种情况:如果整条管道返回0,它不会仅因上游某一步失败而退出。

运行一个没有业务数据的短演示

在Bash中完整复制下面代码,包括两侧括号。false模拟导出失败,后面两步分别压缩和检查压缩流;所有数据都走管道,不写入备份目录。选项只在括号中的子Shell生效,不改变原终端设置。

(
  set +e
  set +o pipefail
  false | gzip -c | gzip -t
  result=( "$?" "${PIPESTATUS[@]}" )
  printf 'pipeline=%s upstream=%s gzip=%s check=%s\n' "${result[@]}"

  set -o pipefail
  false | gzip -c | gzip -t
  result=( "$?" "${PIPESTATUS[@]}" )
  printf 'pipeline=%s upstream=%s gzip=%s check=%s\n' "${result[@]}"
)

工具正常可用时,应得到:

pipeline=0 upstream=1 gzip=0 check=0
pipeline=1 upstream=1 gzip=0 check=0

第一行中,上游已经失败,但默认管道状态仍是0。第二行开启 pipefail,管道才报告失败;压缩与格式检查依然是0,说明它们没有能力判断上游是否导出了有效数据库内容。

PIPESTATUS必须紧接着保存

PIPESTATUS保存最近一次前台管道各阶段的状态,后面的普通命令也会更新它。不要先执行 echo、date 或单独保存 $?,再回来读取这个数组。

演示中的 result=( "$?" "${PIPESTATUS[@]}" ) 在同一条赋值里先展开并保存整体状态与各阶段状态,因此不会漏掉前面的失败。PIPESTATUS和此处数组语法属于Bash;不要把脚本交给 sh 后照搬。

pipefail让管道返回最右侧非零阶段的状态;它不是自动修复,也不代表只要开启就完成了告警。脚本仍要记录失败、保留日志,并避免把失败产物标成正式备份。

检查现有备份任务时看这三层

检查层 需要确认什么
导出过程 真实导出程序的退出码,以及认证、权限、连接、写入错误;不能只看最后一条命令。
文件完整性 文件大小、校验值和gzip检查结果。它们能发现部分传输或压缩损坏,不能证明业务数据齐全。
恢复结果 在隔离环境实际导入,核对对象、关键记录和业务功能,确认所需内容能恢复。

还要检查有没有把 2>&1 放到压缩管道前,使错误文字混入SQL备份。数据输出与错误日志应分别保存;不要用“忽略错误”把失败状态强行改成成功。

不熟悉管道时,优先使用现有教程中的分步导出、立即记录状态、再验证文件的方式。定时脚本的锁、临时产物和完成标记见Linux自动备份与失败检查。发现本批失败时,保留原有可用备份,修复任务后重新导出并试恢复。