Laravel-admin创建用户遇disk [users]未配置报错，求其他解决办法

环境信息 #

• PHP版本：PHP/8.1.10
• Laravel版本：9.28.0
• 开发环境：Windows

问题场景 #

在开发Laravel-admin后端时，尝试向admin_user表插入新用户时触发报错：

disk [users] not configured, please add a disk config in config/filesystems.php

已实现的解决步骤 #

1. 修改config/admin.php，添加磁盘及目录配置：

'disk' => 'users',

// Image and file upload path under the disk above.
'directory' => [
    'image' => 'images',
    'file'  => 'files',
],

2. 修改config/filesystems.php，新增users本地磁盘配置：

'users' => [ 
    'driver' => 'local', 
    'root' => storage_path('app'),
]

3. 重启服务：关闭当前Git Bash窗口后重新执行启动命令：

php artisan serve

4. 验证：访问创建用户页面，报错已解决。

其他可行的解决方法 #

• 复用默认磁盘：无需新增users磁盘配置，直接修改config/admin.php中的disk字段为Laravel已配置好的磁盘（如local、public）。例如：

  'disk' => 'public',
  

  若使用public磁盘，需提前执行php artisan storage:link创建软链接，确保前端能访问上传的文件。
• 替换为云存储磁盘：如果项目有云存储需求，可直接在filesystems.php中配置云驱动类型的users磁盘，比如阿里云OSS、腾讯云COS等（需先安装对应扩展包）。示例（阿里云OSS）：

  'users' => [
      'driver' => 'oss',
      'access_id' => env('OSS_ACCESS_ID'),
      'access_key' => env('OSS_ACCESS_KEY'),
      'bucket' => env('OSS_BUCKET'),
      'endpoint' => env('OSS_ENDPOINT'),
      'is_cname' => env('OSS_IS_CNAME', false),
  ]
  

• 清除配置缓存：如果之前执行过php artisan config:cache生成了配置缓存，修改配置后只需执行php artisan config:clear清除缓存即可，无需手动重启终端或服务。

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