Laravel需鉴权时如何从/storage/manuals返回带资源的HTML页无404

1. 配置路由 #

首先在routes/web.php中添加带权限验证的通配路由，捕获所有 manuals 下的访问请求：

use App\Http\Controllers\ManualController;

// 所有手册请求必须先通过身份验证
Route::get('/manuals/{path}', [ManualController::class, 'serve'])
    ->where('path', '.*') // 匹配带多级斜杠的完整路径
    ->middleware('auth');

这里的路由前缀/manuals要和你HTML里的资源相对路径匹配，避免资源路径偏移。

2. 实现控制器逻辑 #

新建ManualController，完成路径校验、文件返回、安全防护逻辑：

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\Storage;
use Symfony\Component\HttpFoundation\BinaryFileResponse;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

class ManualController extends Controller
{
    public function serve(string $path): BinaryFileResponse
    {
        // 拼接文件存储路径，限定在storage/manuals目录下
        $fullPath = "manuals/$path";
        
        // 处理目录默认访问index.html的情况
        if (Storage::disk('local')->directoryExists($fullPath)) {
            $fullPath = rtrim($fullPath, '/') . '/index.html';
        }

        // 校验文件是否存在，同时防止目录遍历攻击
        if (!Storage::disk('local')->exists($fullPath)) {
            throw new NotFoundHttpException();
        }

        // 获取文件的绝对物理路径
        $absolutePath = Storage::disk('local')->path($fullPath);

        // 返回文件响应，自动匹配正确的MIME类型，设置私有缓存提升访问速度
        return response()->file($absolutePath, [
            'Cache-Control' => 'private, max-age=3600',
        ]);
    }
}

3. 修复页面路径偏移问题 #

如果你的HTML文件中使用了绝对路径（如/css/style.css），只需要在所有HTML的<head>标签中添加base标签统一根路径：

<base href="/manuals/">

如果全部使用相对路径，不需要额外修改，路由规则会自动匹配所有资源、跳转链接的请求。

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