Laravel私有文件服务批量图片加载Pending问题求助

核心原因 #

你遇到的请求排队问题，最可能的诱因是Laravel Session锁阻塞：默认文件Session驱动下，同一用户的所有请求会被Session文件锁强制串行处理，导致大量图片请求只能排队等待；其次是Laravel直接处理文件流的效率远低于专业Web服务器，无法支撑高并发静态资源请求。

具体解决方案 #

1. 解除Session锁对文件请求的限制

如果图片请求不需要会话状态，直接给serveFile路由禁用Session中间件：

Route::get('/serveFile/{address?}', [FileController::class, 'serveFile'])
    ->where('address', '.*')
    ->name('serveFile')
    ->middleware(['web', \Illuminate\Session\Middleware\StartSession::class . ':false']);

若必须保留Session（比如做权限校验），则在控制器中提前释放Session锁：

public function serveFile($address = null)
{
    // 先执行权限验证逻辑（如果有）
    // ...

    // 提前保存并释放Session锁，让后续请求无需等待
    session()->save();

    return response()->file(storage_path($address));
}

长期方案可改用Redis等非阻塞Session驱动，彻底避免文件锁问题。

2. 让Web服务器直接处理文件（性能最优）

Laravel处理文件流的效率远低于Nginx/Apache，推荐用X-Accel-Redirect（Nginx）或X-Sendfile（Apache）让Web服务器直接返回文件，Laravel仅负责权限校验：

Nginx配置示例：

在站点server块中添加内部路由规则：

location /internal-storage/ {
    internal;
    root /你的项目根目录/storage/;
}

修改控制器代码返回重定向头：

public function serveFile($address = null)
{
    // 权限验证逻辑
    // ...

    // 校验路径合法性，防止目录遍历攻击
    $safePath = realpath(storage_path($address));
    if (!$safePath || strpos($safePath, storage_path()) !== 0) {
        abort(403);
    }

    $internalPath = str_replace(storage_path(), '', $safePath);
    return response()->header('X-Accel-Redirect', '/internal-storage' . $internalPath);
}

此方案下，Laravel仅处理权限判断，文件由Nginx直接发送，并发能力会大幅提升。

3. 提升系统并发能力

• 调整PHP-FPM参数：增大pm.max_children、pm.start_servers值，确保有足够进程处理并发请求；
• 启用HTTP/2：HTTP/2支持同一连接的多路复用，可突破HTTP/1.1的并发连接数限制（需Web服务器配置SSL并开启HTTP/2）。

4. 图片加载优化

• 转换图片为WebP/AVIF等现代压缩格式，减小文件体积；
• 生成多尺寸适配图，根据设备返回合适大小的图片；
• 优化懒加载逻辑：用loading="lazy"结合Intersection Observer，仅加载可视区域内的图片。

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