跨分区移动文件在PHP 7.4中必然失败，因rename()是原子操作且仅支持同挂载点，跨分区需copy+unlink降级处理，否则静默失败导致文件残留或丢失。
跨分区移动文件在 PHP 7.4 中必然失败，rename() 不支持跨文件系统操作，这不是权限或路径问题，而是内核级限制。
为什么 rename() 跨分区一定会失败
Linux/Unix 系统中，rename() 是原子操作，仅在同 mount point 下生效；跨分区（如从 /tmp 到 /var/www/uploads）实际需先 copy 再 unlink，而 rename() 不做此降级处理。Windows 下虽部分场景看似成功（NTFS 同磁盘），但跨卷（如 C: → D:）同样失败。
-
rename()返回false，且error_get_last()通常为Warning: rename(): Invalid cross-device link - 该错误属于系统级
E_WARNING，PHP 7.4 默认不抛出异常，需手动捕获或转为异常 - 直接忽略返回值会导致静默失败，目标路径无文件、源文件仍存在——构成典型的文件残留+丢失双风险
用 move_uploaded_file() 替代前必须确认分区一致性
move_uploaded_file() 本质调用 rename()，只是加了上传临时文件校验。它**不解决跨分区问题**，反而可能掩盖真实路径归属。
- 检查
$_FILES['file']['tmp_name']所在分区：运行df -P $(dirname $_FILES['file']['tmp_name'])（CLI）或disk_free_space(dirname($_FILES['file']['tmp_name']))（PHP）可间接推断 - 目标目录所在分区需与
sys_get_temp_dir()或upload_tmp_dir配置一致，否则必须改用copy()+unlink() - 不要依赖
is_writable($target_dir)—— 它只检查权限，不验证是否同分区
安全可靠的 fallback 移动方案（含异常封装）
必须显式区分同分区 rename 和跨分区 copy+unlink，并统一抛出可捕获异常。PHP 7.4 支持多类型 catch，推荐按错误语义分类：
立即学习“PHP免费学习笔记（深入）”；
function safeMoveFile(string $source, string $target): void
{
if (!file_exists($source)) {
throw new RuntimeException("Source file does not exist: {$source}");
}
$sameDevice = @exec("stat -c '%d' " . escapeshellarg($source) . " 2>/dev/null") ===
@exec("stat -c '%d' " . escapeshellarg(dirname($target)) . " 2>/dev/null");
if ($sameDevice && rename($source, $target)) {
return;
}
if (copy($source, $target) && unlink($source)) {
return;
}
throw new RuntimeException("Failed to move {$source} to {$target}");
}
try {
safeMoveFile($_FILES['file']['tmp_name'], '/var/www/uploads/' . basename($_FILES['file']['name']));
} catch (RuntimeException $e) {
// 处理移动失败（含跨分区失败、权限不足、磁盘满等）
error_log('File move failed: ' . $e->getMessage());
http_response_code(500);
}
- 避免用
@抑制警告——它会吞掉Invalid cross-device link提示，改用error_get_last()检查更可控 - Linux 下
stat -c '%d'获取 device ID 是最准判断方式；Windows 可用pathinfo($path, PATHINFO_DRIVE)粗略比对 - copy+unlink 非原子操作，若中途失败（如磁盘满），会导致源文件被删、目标未写全——需在 copy 前确保目标目录有足够空间
PHP 7.4 异常捕获必须覆盖 Throwable，不能只 catch Exception
跨分区失败触发的是 E_WARNING，默认不抛异常；但若你启用了 set_error_handler() 并转成 ErrorException，或底层扩展抛出 Error（如 TypeError 在路径构造时发生），仅 catch (Exception $e) 会漏掉所有错误。
- 兜底写法必须是
catch (Throwable $e)，否则copy()失败时的ErrorException或is_dir()参数类型错误引发的TypeError都不会被捕获 - 不要在 finally 中清理临时文件——如果
copy()失败但unlink()成功，finally 里再删就出错了 - 敏感操作（如用户上传）建议记录设备 ID、源/目标路径、时间戳到审计日志，便于事后追溯分区变更
跨分区移动不是“偶尔失败”，而是“必然失败且不可绕过”。真正要做的不是修复 rename()，而是提前识别、明确降级、全程可审计——否则任何“看起来能跑通”的代码，都在生产环境埋着数据不一致的雷。
