Laravel中视频流返回空白无法播放问题求助

以下是几个关键排查点和修复方案：

1. 确认文件存在且权限正确 #

首先验证视频文件的实际路径和权限：

• public_path('videos/videofile.mp4') 对应项目根目录下的 public/videos/videofile.mp4，确认该文件确实存在
• 确保文件权限为 644（服务器可读），目录权限为 755
• 可以在控制器里先判断文件是否存在，避免返回无效响应：

public function show()
{
    $pathToFile = public_path('videos/videofile.mp4');
    
    if (!file_exists($pathToFile)) {
        abort(404, '视频文件不存在');
    }

    return response()->file($pathToFile, [
        'Content-Type' => 'video/mp4',
    ]);
}

2. 移除手动设置的Content-Length #

response()->file 会自动计算并设置正确的Content-Length头，手动指定可能导致头部信息不匹配，引发播放异常。直接删除该参数即可。

3. 支持浏览器的Range分段请求 #

浏览器播放视频时会发送Range请求来分段加载视频，默认的response()->file不支持这个特性，导致视频无法正常播放。可以改用支持流式分段的响应方式：

use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\StreamedResponse;

public function show(Request $request)
{
    $pathToFile = public_path('videos/videofile.mp4');
    
    if (!file_exists($pathToFile)) {
        abort(404);
    }

    $fileSize = filesize($pathToFile);
    $range = $request->header('Range');

    if ($range) {
        list($start, $end) = explode('-', substr($range, 6));
        $start = (int)$start;
        $end = $end ? (int)$end : $fileSize - 1;
        $length = $end - $start + 1;
        $file = fopen($pathToFile, 'rb');
        fseek($file, $start);

        return response()->stream(function () use ($file, $length) {
            echo fread($file, $length);
            fclose($file);
        }, 206, [
            'Content-Type' => 'video/mp4',
            'Content-Length' => $length,
            'Content-Range' => "bytes {$start}-{$end}/{$fileSize}",
            'Accept-Ranges' => 'bytes',
        ]);
    } else {
        return response()->file($pathToFile, [
            'Content-Type' => 'video/mp4',
            'Accept-Ranges' => 'bytes',
        ]);
    }
}

4. 直接测试路由响应 #

在浏览器地址栏直接访问 http://localhost:8000/playVideo，观察：

• 是否能正常播放视频或下载文件
• 如果出现错误，查看 storage/logs/laravel.log 中的详细错误信息，定位问题

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