store() + Storage::url() 是最稳妥的上传方案；验证需含 mimes、dimensions 和 max，如 'avatar'=>'required|image|mimes:jpeg,jpg,png,gif|dimensions:min_width=100,min_height=100|max:2048'；必须配置 public 磁盘并运行 php artisan storage:link 创建符号链接，否则 URL 无法访问。
直接用 store() + Storage::url() 是最稳妥的起点，别一上来就写 move() 或硬编码路径。
验证规则必须包含 mimes 和 max
只写 required|image 不够。用户可能上传 .exe 伪装成图片，或塞进几百 MB 的 TIFF。实际验证应类似：
'avatar' => 'required|image|mimes:jpeg,jpg,png,gif|dimensions:min_width=100,min_height=100|max:2048'-
mimes比image更可靠，因为后者仅检查文件头，mimes会结合扩展名和 MIME 类型双重校验 -
dimensions要求最低分辨率，避免用户传极小图标（如 16×16 favicon）导致前端显示异常 - 超过 2MB 的图片在移动端上传失败率高，
max:2048是合理上限
store() 默认存到 storage/app/，记得配好 public 磁盘并运行 php artisan storage:link
很多人卡在这步：用 $request->file('avatar')->store('avatars') 后返回路径是 avatars/xxx.png，但浏览器访问 404。原因没配磁盘或没建软链接。
- 确认
config/filesystems.php中public磁盘的url是env('APP_URL').'/storage' - 执行
php artisan storage:link，它会在public/下创建指向storage/app/public/的符号链接 - 真正保存时用
$request->file('avatar')->store('avatars', 'public')，返回路径可直接传给Storage::url() - 别用
public_path()拼接路径再move()—— 绕过 Laravel 文件系统抽象，后续换对象存储（如 OSS）就得重写全部逻辑
头像字段要允许 null，且数据库类型设为 string（不是 text）
用户注册时未必立刻上传头像，avatar 字段必须可空；用 text 存 URL 是浪费，string(255) 足够存带时间戳的路径（如 avatars/202608/abc123.jpg）。
- 迁移里写：
$table->string('avatar')->nullable(); - 如果已有数据，别漏掉
->after('email')或其他字段顺序控制，避免线上表结构错乱 - 更新数据库前先查下当前值：
dd($user->avatar);，防止空字符串、空格或相对路径（如uploads/avatar.png）混入，造成 CDN 或 Nginx 配置失效
最易忽略的是权限与部署一致性：本地 storage:link 成功，不等于生产环境也 OK。Nginx/Apache 必须能读取 storage/app/public/ 下的文件，且 PHP 进程对 storage/ 有写权限 —— 这些错误不会报 PHP 异常，只会静默失败或 403。
