cPanel部署Backpack Laravel出现无效后端配置无可用可读卷报错如何解决

这个报错是Backpack后台集成的elFinder文件管理器无法识别可用的可读存储卷导致的，可按以下步骤排查修复：

1. 调整上传目录权限 #

cPanel环境下web运行用户对上传目录需要有读写权限，按以下操作设置：

• 在cPanel文件管理器中找到项目public/uploads目录，右键选择「修改权限」，设置权限为755，如果权限设置后仍报错可临时设为777验证是否为权限问题
• 同时确认项目storage目录及其子目录权限同样设置为755，目录所属用户组与cPanel web服务运行用户保持一致

如果你有SSH权限可直接执行命令修改：

chmod -R 755 /path/to/your/project/public/uploads
chmod -R 755 /path/to/your/project/storage

2. 修正elFinder存储配置 #

默认Backpack的elFinder配置指向storage/app/public目录，你使用自定义的public/uploads目录需要手动修改配置：

• 首先发布elFinder配置文件，在项目根目录执行命令：

  php artisan vendor:publish --provider="Backpack\CRUD\BackpackCRUDServiceProvider" --tag="elfinder-config"
  

• 打开生成的config/elfinder.php文件，找到roots配置段，修改为以下内容：

  'roots' => [
      [
          'driver' => 'LocalFileSystem',
          'path'   => public_path('uploads'), // 匹配你的本地上传目录绝对路径
          'URL'    => url('uploads'), // 匹配上传目录的web访问地址
          'access' => 'Barryvdh\Elfinder\Elfinder::checkAccess',
          'uploadAllow' => [],
          'uploadDeny'  => [],
          'uploadOrder' => ['deny', 'allow'],
      ],
  ],
  

3. 清理Laravel缓存 #

配置修改完成后清理旧的配置缓存，避免旧配置生效：

php artisan config:clear
php artisan cache:clear

操作完成后刷新Backpack后台页面即可正常访问文件上传功能。

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