Laravel Backpack upload_multiple字段文件链接返回404错误的问题求助

遇到这种404问题，我帮你梳理几个实用的排查方向，应该能快速定位解决：

虽然你执行了php artisan storage:link，但这个命令可能因为权限或系统环境限制没创建成功：

• Linux/macOS：直接到项目的public目录下，查看是否有storage软链接，它应该指向../storage/app/public；
• Windows：Laravel内置的storage:link在部分环境下可能失效，需要手动用命令创建：mklink /D public\storage storage\app\public。
  如果没有这个链接，先搞定它，这是文件能被外部访问的基础前提。

你的模型里已经指定用public磁盘存储，但在Backpack的字段定义中（不管是新增/编辑页的addField，还是查看/列表页的addColumn），没有明确绑定磁盘属性，导致生成的链接缺少/storage前缀。你需要给字段加上disk参数：

// setupCreateOperation 中的字段配置
CRUD::addField([
    'name' => 'documents',
    'label' => 'Documents',
    'type' => 'upload_multiple',
    'upload' => true,
    'disk' => 'public', // 新增这一行
]);

// setupShowOperation 中的字段配置
CRUD::addColumn([
    'name' => 'documents',
    'label' => 'Documents',
    'type' => 'upload_multiple',
    'disk' => 'public', // 列表/查看页的字段也需要加
]);

加上这个配置后，Backpack会根据public磁盘的规则生成正确链接：http://localhost/storage/documents/xxx.pdf，而不是现在缺少前缀的/documents/xxx.pdf。

打开config/filesystems.php，检查public磁盘的URL配置是否正确：

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage', // 确保这一行带/storage前缀
    'visibility' => 'public',
],

如果url配置错误（比如少了/storage），生成的链接自然会指向错误路径。确认后执行php artisan config:clear清理配置缓存。

旧的配置缓存可能导致路径不生效，执行以下命令彻底清理：

php artisan config:clear
php artisan cache:clear
php artisan view:clear

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