Laravel 8自定义filesystems磁盘配置后对应图片URL无法访问

你配置的自定义磁盘URL无法访问，核心原因是仅配置了文件系统的逻辑访问地址，没有配置该地址到实际存储目录的映射规则，具体分析及解决方法如下：

原因分析 #

• 默认public磁盘对应的/storage路径是通过Laravel官方默认的软链规则支持的：运行php artisan storage:link时，会自动在项目public目录下创建名为storage的软链，指向storage/app/public目录，因此所有/storage/*前缀的请求都能找到对应文件。
• 你自定义的public_collectible_img磁盘设置的URL前缀是/collectible/image，但没有对应软链/路由规则，Web服务器会直接到public目录下找collectible/image/0_test.jpg物理文件，该路径不存在所以返回404。

解决方案 #

你可以根据自己的需求选择以下任意一种方案解决：

方案1：新增软链映射（性能更高，适合公开静态资源） #

1. 打开config/filesystems.php，找到links配置项，新增一条映射规则：

'links' => [
    public_path('storage') => storage_path('app/public'),
    // 新增自定义路径的软链映射
    public_path('collectible/image') => storage_path('app/public/collectibles_img'),
],

2. 执行命令php artisan storage:link创建软链，Windows环境需要用管理员权限运行终端再执行该命令，避免软链创建失败。
   配置完成后访问自定义前缀的URL即可正常加载资源。

方案2：路由解析（灵活度高，适合需要权限控制的资源） #

如果你的资源需要做访问权限校验，可以通过路由动态返回文件，在routes/web.php中添加如下路由规则：

Route::get('/collectible/image/{filename}', function ($filename) {
    // 可在此处添加权限校验逻辑
    return response()->file(
        Storage::disk('public_collectible_img')->path($filename)
    );
})->where('filename', '.*');

补充注意事项 #

• 检查你的.env文件中APP_URL配置是否为http://localhost/myProject/public，和你实际的项目访问前缀保持一致即可，无需额外修改磁盘的URL配置。
• 如果是部署到生产环境，优先选择软链方案，静态资源直接由Web服务器处理，性能远高于PHP路由解析的方案。

内容的提问来源于stack exchange，提问作者Carol.Kar