gzip报文件意外结束:备份在哪一步损坏

适用范围:gzip压缩文件;不是加密文件、分卷格式或其他压缩格式的通用修复方法。

下载的备份打不开并提示unexpected end of file,不要立刻删除它,也不要尝试把解出的半份SQL导入正式库。先判断问题出在下载副本,还是服务器上那份源文件已经不完整。

保留原件并检查格式

在文件已经停止写入的前提下,分别对源文件和下载副本执行只读检查。以下文件名为示例:

ls -lh -- backup.sql.gz
file -- backup.sql.gz
gzip -t -- backup.sql.gz
rc=$?
printf 'gzip检查退出码=%s\n' "$rc"

退出码要立即保存。GNU gzip中,0表示此次压缩流检查通过,1表示错误,2表示警告;非零时同时保留具体报错,不能只看一个数字判断损坏范围。gzip -t 只检查压缩流,不把SQL导入数据库,也不证明数据库内容完整。[1]

如果file显示HTML或文本错误页,可能下载到登录页或失败响应,而不是备份;先修正下载权限和地址。加密文件应先按其加密方案处理,不能因gzip不认识就判它损坏。

对比来源与目标的同一批文件

sha256sum -- backup.sql.gz

在两端比较大小和SHA256,同时确认日期、批次与文件名确为同一份。源文件仍在生成时复制,比较结果没有意义;需要等备份任务结束并确认状态。

两端不同:优先重新传输到新文件名,保留失败副本用于排查。两端相同但都校验失败:重下同一份不会修好,应检查源备份任务及其生成日志。[2]

GNU gzip 1.13隔离实测:完整样例退出码为0,人工截断样例报错。样本不含业务数据。
GNU gzip 1.13隔离实测:完整样例退出码为0,人工截断样例报错。样本不含业务数据。 点击图片可查看原尺寸。

找出源文件为何不完整

检查导出工具和压缩步骤的退出码、目标磁盘与配额、任务是否中断、是否有两个任务写同一个路径。压缩步骤成功与数据库导出成功要分开判断。

备份脚本应写入独立临时产物,确认所有步骤完成后再发布完成标记或正式文件名。不要用忽略错误的选项把失败批次标成成功。

不用部分解压结果替代备份

截断文件有时能解出前一部分,但可能缺少表尾、索引、约束或事务收尾。不能因里面“有很多SQL”就用于覆盖生产库。数据抢救应在隔离环境由理解数据结构的人处理,并清楚标注不完整范围。

恢复验证才是最后一关

取得新的完整批次后,再做哈希比对、gzip校验和隔离恢复。核对关键表、记录与业务功能。保留上一份已验证可恢复的备份,不要在新批次还没验收时提前清理它。

继续排查

备份命令显示成功,为什么文件仍不可用;备份下载后如何核对SHA256;备份失败:空间、权限与日志排查。

技术依据:[1] gzip检查与退出状态;[2] GNU sha256sum说明。适用版本见本文说明。