Laravel Storage Facade删除文件失败问题排查求助

问题原因 #

你传递给Storage::delete()的是绝对路径，但Laravel的Storage Facade要求传入的是对应磁盘根目录的相对路径。

你的local磁盘根目录配置为storage_path('app')，而你用storage_path($filePath . 'ExcelData.xlsx')生成的是完整绝对路径，这会导致Storage尝试在storage/app/下再拼接这个绝对路径，实际访问的是一个不存在的路径。因为throw配置为false，所以不会抛出异常，反而返回true（默认行为是找不到文件时返回true）。

修复代码 #

直接使用相对于local磁盘根目录的路径即可：

// 相对路径：对应 storage/app/data-export/ExcelData.xlsx
$excelFile = 'data-export/ExcelData.xlsx';
$deleted = Storage::disk('local')->delete($excelFile);

如果默认磁盘是local（默认配置就是），也可以简化为：

$excelFile = 'data-export/ExcelData.xlsx';
$deleted = Storage::delete($excelFile);

调试验证 #

可以先检查文件是否存在，确认路径正确：

$excelFile = 'data-export/ExcelData.xlsx';
if (Storage::disk('local')->exists($excelFile)) {
    $deleted = Storage::disk('local')->delete($excelFile);
    dd($deleted); // 此时文件应被删除，返回true
} else {
    dd('文件不存在，请检查路径');
}

额外建议 #

开发环境建议开启磁盘的throw配置，这样当文件不存在或操作失败时会直接抛出异常，更易排查问题：
修改config/filesystems.php中local磁盘的配置：

'local' => [
    'driver' => 'local',
    'root'   => storage_path('app'),
    'throw'  => true, // 改为true
],

内容的提问来源于stack exchange，提问作者IanP