laravel-admin上传失败主因是磁盘未配置、软链接缺失或目录权限错误：需在config/filesystems.php中定义'admin'磁盘（root指向public_path('uploads')）、在config/admin.php中upload.disk设为'admin'、确保public/uploads目录存在且web用户有读写权限，并配置nginx/apache将/uploads/路径映射到该目录。
laravel-admin 上传失败，90% 是磁盘没配对、软链接没建、或目录权限不对
确认 config/filesystems.php 中是否定义了 'admin' 磁盘
laravel-admin 默认不使用 Laravel 原生的 public 磁盘，而是读取配置里的 disk 项（默认值为 'admin'）。如果没在 config/filesystems.php 的 disks 数组里声明这个磁盘，上传会直接报错或静默失败。
- 必须手动添加一段类似这样的配置：
'admin' => [
'driver' => 'local',
'root' => public_path('uploads'),
'visibility' => 'public',
'url' => env('APP_URL') . '/uploads',
],
注意：root 指向的是物理路径（比如 /var/www/html/public/uploads），不是 storage/app/xxx；url 是前端能访问的 URL 前缀，必须和 Web 服务器实际映射路径一致。
别把 root 写成 storage_path('app/uploads')——那会导致文件存到不可访问的目录，且 laravel-admin 的 Storage::url() 会拼出错误 URL。
检查 config/admin.php 的 upload 配置是否指向正确磁盘
打开 config/admin.php，找到 upload 配置块。关键两项是：
-
disk：必须和config/filesystems.php里定义的磁盘名完全一致，比如'admin'；写成'public'却没配public磁盘，就会 fallback 到 local 并存进storage/app/，但前端访问不到 -
directory.image：这是子路径，最终文件会存在public/uploads/images/xxx.jpg（假设 root 是public_path('uploads')）
常见错误是只改了 disk，却忘了同步更新 filesystems.php，或者把 directory.image 写成带前导斜杠的 '/images'，导致路径变成 public/uploads//images/xxx，Linux 下可能创建失败或行为异常。
确保 public/uploads 目录存在且 Web 用户可写
laravel-admin 用的是 local 驱动 + 自定义 root，所以它不会走 php artisan storage:link 那套逻辑。你得自己保证：
-
public/uploads目录真实存在（运行mkdir -p public/uploads） - Web 服务器用户（如
www-data或nginx）对该目录有rwx权限：sudo chown -R www-data:www-data public/uploads和sudo chmod -R 775 public/uploads - 如果用了 Docker，容器内用户 UID 必须和宿主机一致，否则权限失效
上传后可以手动进 public/uploads/images/ 看文件是否生成；如果目录空，大概率是权限或路径写错 —— 此时 storage/logs/laravel.log 里通常有 file_put_contents(): Failed to open stream: Permission denied 这类明确报错。
富文本编辑器图片 src 404？重点查 URL 拼接和 Nginx/Apache 配置
即使文件成功存进 public/uploads/images/，前端仍显示 404，问题一定出在 URL 生成或 Web 服务器静态路由上。
- laravel-admin 的
Storage::url()会按config/filesystems.php里该磁盘的url配置来拼地址，比如https://yoursite.com/uploads/images/abc.jpg - 这个 URL 必须被 Nginx/Apache 映射到
public/uploads物理路径；如果你用的是 Nginx，需确认 server 块里有类似这段：
location /uploads/ {
alias /var/www/html/public/uploads/;
}
漏掉这句，或 alias 路径写错（比如少了个 / 或多写了 public），都会导致 404。Apache 用户则要确认 .htaccess 或虚拟主机配置允许该路径直出。
真正容易被忽略的是：laravel-admin 的图片上传路径和 URL 是解耦的 —— 存储位置由 root 决定，访问地址由 url 决定，而 Web 服务器是否响应这个地址，又取决于它自己的配置。三者只要一个不匹配，图片就挂。
