Laravel 9图片更新异常：更新方法生效但图片未变更

问题详情 #

在Laravel中实现店铺图片更新功能时，控制器方法可正常执行，数据库字段也能同步更新，但图片并未完成替换。已尝试调整路径斜杠等操作，问题仍未解决。

相关代码 #

控制器代码 #

$shop = Shop::find($id);
$shop->name = $request->input('name');
$shop->email = $request->input('email');
$shop->address = $request->input('address');
$shop->number = $request->input('number');
$shop->description = $request->input('description');


if($request->hasFile('image'))
{
    $destination = 'storage/shops/' . $shop->image;
    if(File::exists($destination))
    {
        File::delete($destination);
    }
    $file = $request->file('image');
    $extension = $file->getClientOriginalExtension();
    $filename = time(). '.' . $extension;
    $file->move('storage/shops/', $filename);
    $shop->image = $filename;
}
$shop->update();
return redirect()->route('shops');

Blade视图代码 #

@foreach($shops as $shop)
    <img src="{{ asset('storage/shops/' . $shop->image) }}" width="880" height="650" class="card" alt="No image">
    <div class="card-body">
        <h1 class="flex-auto text-lg font-semibold text-slate-900 text-center">
            <a href="{{ route('shops_show', $shop->id) }}"><h5 class="card-title">{{ $shop->name }}</h5></a>
        </h1>
        <div class="w-full flex-none text-sm font-medium text-slate-700 mt-2 text-center">
            <p class="card-text">{{ $shop->description }}</p>  
        </div>
    </div>
@endforeach

排查与修复方案 #

1. 修正文件路径判断与存储逻辑 #

Laravel中storage/app/public/是默认公开存储目录，需通过storage_path()函数拼接正确物理路径：

if($request->hasFile('image') && $request->file('image')->isValid()) {
    // 拼接正确的旧文件物理路径
    $oldImagePath = storage_path('app/public/shops/' . $shop->image);
    if(File::exists($oldImagePath)) {
        File::delete($oldImagePath);
    }
    
    $file = $request->file('image');
    $extension = $file->getClientOriginalExtension();
    $filename = time(). '.' . $extension;
    // 将文件移动到正确的公开存储目录
    $file->move(storage_path('app/public/shops/'), $filename);
    $shop->image = $filename;
}

2. 验证模型可填充字段 #

检查Shop模型的$fillable属性是否包含image字段，否则无法通过赋值更新数据库：

class Shop extends Model
{
    protected $fillable = ['name', 'email', 'address', 'number', 'description', 'image'];
}

或改用$shop->save()替代$shop->update()，对已获取的模型实例，save()执行逻辑更稳定。

3. 解决浏览器缓存问题 #

在图片URL后追加更新时间戳，强制浏览器加载新图片：

<img src="{{ asset('storage/shops/' . $shop->image) }}?v={{ $shop->updated_at->timestamp }}" width="880" height="650" class="card" alt="No image">

4. 确认存储软链接已创建 #

若未执行过storage:link命令，前端无法访问存储目录的文件，执行以下命令创建软链接：

php artisan storage:link

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