Symfony 6.2 中 Filesystem::copy() 默认静默失败，仅返回布尔值且不抛异常，需主动检查源文件存在性、目标目录可写性，并结合 error_get_last() 捕获 PHP 警告，或封装为显式抛异常的工具方法。
在 Symfony 6.2 中使用 Filesystem::copy() 时，异常不会自动抛出——它默认静默失败（比如目标目录不可写、源文件不存在、权限不足等），只返回布尔值或触发 PHP 警告。因此必须主动检查并捕获潜在问题，不能依赖 try/catch 包裹 copy() 就万事大吉。
明确判断返回值 + 检查前置条件
copy() 方法本身不抛异常，而是返回 true 或 false。你需要结合路径存在性、可写性等系统级检查，提前拦截常见失败原因：
- 用
file_exists($source)确认源文件真实存在，避免“找不到源文件”却无提示 - 用
is_dir($targetDir) && is_writable($targetDir)验证目标目录就绪；若不满足，不要直接调用 copy()，先创建目录：mkdir($targetDir, 0755, true) - 确保目标文件名不含路径遍历字符（如
../），建议用basename($targetName)过滤
启用错误报告并监听 warning
Symfony Filesystem 在底层调用 PHP 原生 copy() 函数，失败时会触发 E_WARNING。你可以临时提升错误级别捕获它：
Kadence Theme Design System
下载
使用 Kadence 主题作为 WordPress 项目的设计系统，涵盖设计令牌、布局系统、页头/页脚/导航设置以及页面/归档/单篇文章模板。
- 在 copy 前加：
$oldErrorLevel = error_reporting(E_ALL); - 执行
$result = $filesystem->copy($source, $target, $override); - 恢复报错级别：
error_reporting($oldErrorLevel); - 若
$result === false，说明出错；此时可结合error_get_last()获取最后一次 warning 信息（如"Permission denied"或"No such file or directory"）
封装成带异常的工具方法
推荐将复制逻辑封装为显式抛出异常的方法，便于统一处理：
- 检查源文件：
if (!is_readable($source)) { throw new \RuntimeException("Source file not readable: $source"); } - 确保目标父目录可写：
$targetDir = dirname($target); if (!is_dir($targetDir) || !is_writable($targetDir)) { throw new \RuntimeException("Target directory not writable: $targetDir"); } - 执行复制并验证结果：
if (!$filesystem->copy($source, $target, $override)) { throw new \RuntimeException("Failed to copy $source to $target"); }
这样既符合 Symfony 的健壮性习惯，也避免了因静默失败导致后续流程误判。
