本文介绍在 laravel 中通过任务调度实现图片文件与数据库记录的自动清理：将上传的图片存入 storage/app/public，并设置 24 小时后自动删除文件及关联数据，重点纠正路径误用、推荐使用 storage 门面而非直接操作 public_path()。
本文介绍在 laravel 中通过任务调度实现图片文件与数据库记录的自动清理：将上传的图片存入 storage/app/public，并设置 24 小时后自动删除文件及关联数据，重点纠正路径误用、推荐使用 storage 门面而非直接操作 public_path()。
在 Laravel 应用中，用户上传的图片常需设置生命周期策略（如“24 小时后自动清理”），以节省存储空间并保障数据时效性。但实践中容易因路径理解偏差导致清理失败——典型错误是：将图片写入 Storage::disk('public')，却尝试用 public_path('storage/...') + unlink() 删除。这会导致文件始终无法被清除，因为 Storage::disk('public') 实际映射到 storage/app/public 目录，而 public_path('storage') 指向的是 public/storage（即软链接目标），二者物理路径不同。
✅ 正确做法：统一使用 Storage 门面操作文件
Laravel 的 Storage 门面专为抽象文件系统操作而设计，能自动适配底层驱动（本地、S3 等），且路径语义清晰。修改后的清理逻辑如下：
// app/Console/Kernel.php —— 在 schedule 方法内注册每日任务
protected function schedule(Schedule $schedule)
{
$schedule->call(function () {
$now = Carbon::today(); // 使用 Carbon::today() 更语义化，等价于 Carbon::now()->format('Y-m-d')
$expiredMedia = ReceivedMedia::whereDate('delete_at', $now)->get();
foreach ($expiredMedia as $media) {
// ✅ 正确：使用 Storage::disk('public')->exists() 和 ->delete()
if ($media->media && Storage::disk('public')->exists($media->media)) {
Storage::disk('public')->delete($media->media);
}
// 删除数据库记录
$media->delete();
}
})->daily(); // 每日凌晨执行（可按需调整：->dailyAt('03:00')）
}? 关键注意事项
-
路径一致性：控制器中保存路径 $pathMedia = "/media/{$aid}-" . uniqid() . ".jpg" 是相对路径（无前导 / 更佳），应确保与 Storage::disk('public') 的根目录匹配。建议统一写法：
$pathMedia = 'media/' . $aid . '-' . uniqid() . '.jpg'; // 推荐：无开头斜杠，更符合 Laravel 路径约定 Storage::disk('public')->put($pathMedia, $image); -
时间字段类型优化：数据库中 delete_at 字段建议设为 DATE 或 DATETIME 类型（非字符串），便于后续查询与索引优化。若当前为 VARCHAR，可迁移修正：
// php artisan make:migration change_delete_at_to_date_in_received_media_table Schema::table('received_media', function (Blueprint $table) { $table->date('delete_at')->change(); // 需安装 doctrine/dbal });对应模型中添加日期转换：
// app/Models/ReceivedMedia.php protected $casts = [ 'delete_at' => 'date', ]; -
健壮性增强（可选）：增加日志与异常捕获，便于排查失败任务：
\Log::info("Starting cleanup of expired media at {$now}"); try { // ... 清理逻辑 } catch (\Exception $e) { \Log::error("Failed to cleanup expired media: " . $e->getMessage()); }
✅ 总结
实现图片自动过期清理的核心在于：文件操作与存储配置严格对齐，优先使用 Storage 门面而非手动拼接物理路径。配合 Laravel 的任务调度器，即可构建稳定、可维护的定时清理机制。务必验证 storage:link 已正确运行（确保 public/storage 软链接存在），并定期检查日志确认任务执行状态。
