Laravel 10媒体文件下载损坏问题求助

问题描述 #

开发Laravel项目实现用户文件存储下载功能，文件存储路径为storage/app/public/(user_id)，已通过软链接关联到public/storage/(user_id)，服务器目录中的文件正常，但下载到本地后图片、视频等媒体文件均损坏。

相关代码 #

文件下载控制器

public function downloadFile(Request $request)
{
    $ruta = $request->input('ruta');
    $nombre = $request->input('filename');
    $ruta = public_path('storage/' . $ruta);
    return response()->download($ruta, $nombre);
}

文件上传控制器

public function store(Request $request)
{
    $request->validate([
        'archivo' => 'required|file|max:10240',
    ]);

    $carpetaUsuario =  Auth::id();
    $archivo = $request->file('archivo');
    $nombreArchivo = $archivo->getClientOriginalName();
    
    $ruta = Storage::disk('public')->put($carpetaUsuario, $archivo);
    $size_file = $archivo->getSize();
    $size_file = $size_file / 1024;
    $extension = pathinfo($ruta, PATHINFO_EXTENSION);

    $archivo = new Archivo();
    $archivo->nombre = $nombreArchivo;
    $archivo->ruta = $ruta;
    $archivo->usuario_id = Auth::user()->id;
    $archivo->tipo = $extension;
    $archivo->tamanio_archivo = $size_file;
    
    $archivo->save();
        
    return redirect()->back()->with('success', 'Archivo subido correctamente.');
}

视图核心代码

<div class="archivos-list">
    @foreach($archivos as $archivo)
    <div class="archivo-card">
    <p data-id="{{ $archivo->id }}">{{ $archivo->nombre }}</p>
        <form method="POST" action="{{ route('download.file', $archivo) }}">
            @csrf
            <input type="hidden" name="ruta" value="{{ $archivo->ruta }}"> 
            <input type="hidden" name="filename" value="{{ $archivo->nombre }}"> 
            <button type="submit" class="download-btn">
                <span class="material-icons">file_download</span>
            </button>
        </form>
    </div>
@endforeach
</div>

filesystems.php 配置

'disks' => [
    'local' => [
        'driver' => 'local',
        'root' => storage_path('app'),
    ],

    'public' => [
        'driver' => 'local',
        'root' => storage_path('app/public'),
        'url' => env('APP_URL').'/storage',
        'visibility' => 'public',
    ]
],
'links' => [
    public_path('storage') => storage_path('app/public'),
],

问题根源 #

下载控制器中直接用public_path('storage/' . $ruta)拼接路径存在错误：Storage::disk('public')->put()返回的$ruta已经是基于storage/app/public的相对路径（比如1/abc123.jpg），而public_path('storage/')指向的是public/storage软链接目录，直接拼接会导致读取路径偏差，或者读取到无效内容，最终导致下载的文件损坏。此外，未指定正确的MIME类型也可能导致本地无法正常解析文件。

修复方案 #

1. 修正下载控制器代码 #

使用Laravel Storage门面获取正确的文件路径，并指定MIME类型：

public function downloadFile(Request $request)
{
    $ruta = $request->input('ruta');
    $nombre = $request->input('filename');
    
    // 检查文件是否存在
    if (!Storage::disk('public')->exists($ruta)) {
        abort(404, 'Archivo no encontrado');
    }
    
    // 获取文件真实路径与MIME类型
    $archivoRuta = Storage::disk('public')->path($ruta);
    $mimeType = Storage::disk('public')->mimeType($ruta);
    
    return response()->download($archivoRuta, $nombre, ['Content-Type' => $mimeType]);
}

2. 确保软链接有效 #

重新创建存储软链接，避免链接失效：

php artisan storage:link

3. 可选优化：保留原文件名上传 #

如果需要避免Laravel自动生成的随机文件名，可改用putFileAs方法上传：

// 替换原上传逻辑中的$ruta赋值
$ruta = Storage::disk('public')->putFileAs(
    $carpetaUsuario, 
    $archivo, 
    $nombreArchivo,
    'public'
);

验证步骤 #

1. 上传新的测试文件，确认数据库中ruta字段格式为user_id/文件名
2. 下载该文件，检查本地文件是否可正常打开
3. 对比服务器storage/app/public/(user_id)下的文件与原上传文件的大小、MD5值是否一致

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