PHP 8.2 的 stream_copy_to_stream 复制 4GB 只写 2GB 返回值为何没报错

备份脚本每晚把 4.2GB 的数据库快照拷到 NAS,日志一直打印 copied ok。真到恢复演练,解压报 unexpected end of file,文件只有 2.1GB。

脚本里写的是 $n = stream_copy_to_stream($in, $out); if ($n === false) { throw ... }。返回值不是 false,是 2147483648,脚本就认为成功了。

我第一反应是 NAS 的 SMB 挂载断过。查 dmesg,确实有 CIFS: VFS: Send error in write,但那天的日志里只有一条,时间对不上。df 一看,挂载点只剩 0 字节,写到 2GB 时盘满了。

关键点是流复制遇到短写不会抛异常,它把实际写进去的字节数返回,剩下的静默丢掉。copy() 也一样,返回值只代表有没有出错,不代表写全。

试过加 fflush 再 filesize 对比,filesize 有 stat 缓存,读到的是旧值,还是 4.2GB。改成 fstat($in)['size'] 拿源文件真实大小,才对上。

现在脚本里三件事:比对复制字节数和源大小、fflush 后调 fSYNc 落盘、两端各算一次 sha256。任何一步不等就删掉目标文件并告警,不再留下半个包。

改完重跑,同样的满盘场景直接报 short write 2147483648/4509715660,退出码 1,监控收到告警。清出空间再跑,4.2GB 完整落盘,sha256 一致。

$in  = fopen($src, 'rb');
$out = fopen($dst, 'wb');
$size = fstat($in)['size'];
$n = stream_copy_to_stream($in, $out);
fflush($out);
if (function_exists('fsync')) {
    fsync($out);
}
if ($n !== $size) {
    throw new RuntimeException("short write $n/$size");
}

您可以还会对下面的文章感兴趣: