备份文件末尾截断或内容不全是最典型的“损坏”现象，主因是PHP写入未刷缓冲就终止、Web超时中断、编码不匹配、权限不足或磁盘满，关键在于写入过程未闭环验证。
备份文件末尾截断或内容不全
这是最典型的“损坏”现象：用 mysql 导入时报错类似 ERROR 1064 (42000)，提示 SQL 语法错误，实际是文件最后几行被砍掉了。根本原因往往是 PHP 写入文件时未等缓冲区刷出就结束脚本，尤其在使用 fwrite() + exec() 混合方式时容易发生。
- 不要用
fopen()手动拼接 SQL —— 即使加了fflush()和fclose()，也难保mysqldump子进程的输出流完全落盘 - 优先用
shell_exec()或exec()直接调用mysqldump并重定向到文件，让系统 IO 层统一管理写入完整性 - 执行后必须检查返回码：
$return === 0是硬性门槛；若为非零值（如 2、5），说明mysqldump自身报错，此时生成的 .sql 文件大概率不完整
PHP执行超时导致备份中断
PHPCMS 后台点击“备份”按钮后页面卡住或返回空白，日志里出现 Maximum execution time of 30 seconds exceeded，结果生成的 .sql 文件只有几 KB。这不是文件“损坏”，而是压根没写完就被 PHP 强制终止了。
- Web 环境下禁止依赖
set_time_limit(0)—— 它在某些 SAPI（如 PHP-FPM）中无效，且会拖垮整个请求队列 - 真正安全的做法是把备份任务交给 CLI 模式：写一个独立的 PHP 脚本，用
php /path/to/backup.php运行，不受 Web 超时限制 - 如果必须走 Web 触发，至少用
ignore_user_abort(true)+set_time_limit(0)双保险，并在脚本开头加ob_end_clean();防止输出缓冲干扰
字符编码混杂导致导入失败
备份文件用文本编辑器打开看似正常，但导入时中文变乱码、字段名含特殊符号报错，甚至部分 INSERT 语句直接跳过。这通常不是损坏，而是 mysqldump 输出与目标数据库的 character_set_client / collation_connection 不匹配。
- 强制指定导出编码：
mysqldump --default-character-set=utf8mb4 -u ...，避免依赖 MySQL 服务端默认值 - 在生成的 .sql 文件头部手动插入
SET NAMES utf8mb4;（注意不是utf8），比靠客户端自动识别更可靠 - 不要用 Windows 记事本编辑备份文件 —— 它会悄悄把 UTF-8 文件存成带 BOM 的格式，MySQL 导入时可能在第一行报错
文件权限或磁盘满导致写入静默失败
备份操作返回“成功”，但目标目录下没有文件，或文件大小恒为 0 字节。常见于 PHPCMS 的 data/backup/ 目录权限不足，或服务器磁盘已满，而 PHP 没做写入结果校验。
立即学习“PHP免费学习笔记（深入）”；
- 执行
mysqldump前先检查目标路径可写：is_writable($backupDir)，否则提前报错 - 执行后立刻验证文件存在且大小 > 0：
file_exists($file) && filesize($file) > 1024（1KB 是合理下限） - 用
disk_free_space($backupDir)预留至少 2 倍数据库大小的空闲空间，防止导出中途因磁盘满而中断
