Laravel中使用unlink删除多张本地存储照片不生效问题

核心代码问题定位 #

• 动态取值逻辑完全错误：你代码里写的$gallery->image_ . $i，实际是访问模型上不存在的image_属性，拿到空值后直接拼接循环变量$i，最终拼出的路径是storage/app/public/1、storage/app/public/2这类无效地址，永远匹配不到真实的图片文件，file_exists判断永远不成立，自然不会执行删除操作。
• 错误使用错误抑制符：代码里给unlink加了@前缀，会直接屏蔽文件操作的所有报错，就算后续出现权限不足、路径不匹配的问题，也看不到具体错误提示，排查完全没有抓手。
• 无空值校验逻辑：如果某条记录对应的图片字段为空，拼出来的路径会直接指向storage根目录下的无效路径，存在误删同目录其他文件的风险。
• 原生文件操作和框架磁盘路径不兼容：没有使用Laravel内置的文件存储门面，手动拼接storage_path的方式，很容易因为磁盘配置调整、符号链接路径变化导致路径和实际存储位置错位。

修正后的可运行实现 #

// 引入Laravel内置的Storage门面
use Illuminate\Support\Facades\Storage;

public function destroy(Gallery $gallery)
{
    for ($i = 1; $i < 9; $i++) {
        // 正确动态访问模型上的image_1到image_8字段
        $imageFieldValue = $gallery->{'image_' . $i};
        // 字段为空则直接跳过后续判断
        if (empty($imageFieldValue)) {
            continue;
        }
        // 调用public磁盘的内置方法判断文件存在并删除，无需手动拼接全路径
        if (Storage::disk('public')->exists($imageFieldValue)) {
            Storage::disk('public')->delete($imageFieldValue);
        }
    }
    // 所有关联文件删除完成后，再清除数据库记录
    $gallery->delete();
}

额外需要核查的环境配置 #

• 确认已执行php artisan storage:link生成public目录下的软链接，图片文件实际存储在storage/app/public目录下，没有和public目录下的其他业务文件路径混淆。
• 给Web运行进程（如www-data、nginx）配置storage目录的写入、删除权限，避免权限不足导致的删除失败。
• 开发环境下去掉文件操作的错误抑制符，打开完整报错提示，出现路径、权限问题时可以直接定位。

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