Storage::put() 写入后无法通过 URL 访问的最常见原因是未运行 php artisan storage:link，因 public 磁盘默认存至 storage/app/public，而 Web 服务器仅能访问 public/ 下路径，必须创建 public/storage → storage/app/public 符号链接才能使 asset('storage/file.jpg') 生效。
直接用 Storage facade 就行，但必须先配好磁盘、建好符号链接、装对扩展包——漏掉任意一环都会报错或文件不可访问。
为什么 Storage::put() 写进去了却打不开 URL？
最常见原因是没运行 php artisan storage:link。public 磁盘默认存到 storage/app/public，但 Web 服务器只能访问 public/ 下的路径。不建符号链接，asset('storage/file.jpg') 指向的路径根本不存在。
- 确认
config/filesystems.php中public磁盘的root是storage_path('app/public') - 运行
php artisan storage:link——该命令只创建public/storage → storage/app/public这一条链接 - 若需额外链接（如
public/images），在config/filesystems.php的links数组里声明，再重跑命令 - 部署到生产环境时，确保符号链接被保留（有些 CI/CD 工具会清空
public/目录）
Storage::disk('s3') 报错 “Class 'Aws\Sdk' not found” 怎么办？
这是典型的驱动依赖缺失：Laravel 不自带 S3 SDK，必须手动装包。而且要注意版本兼容性。
- 执行
composer require league/flysystem-aws-s3-v3 "^3.0"（不是~1.0，那是旧版） - 检查
config/filesystems.php中s3磁盘的配置是否引用了正确的环境变量，比如'key' => env('AWS_ACCESS_KEY_ID') - 确保
.env里填了AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_DEFAULT_REGION、AWS_BUCKET - 如果用 IAM 角色（如 EC2 实例），可删掉
key和secret，但必须保证实例有对应权限
本地开发用 local 磁盘，怎么控制文件权限？
默认情况下，public 可见性生成的文件是 0644，目录是 0755，但某些共享主机或 Docker 环境要求更严格的权限（比如禁止组写入）。
立即学习“PHP免费学习笔记（深入）”；
- 在
config/filesystems.php的local磁盘配置里加permissions键 - 例如：
'permissions' => ['file' => ['public' => 0644], 'dir' => ['public' => 0755]] - 注意：这个设置只影响
put()、makeDirectory()等写操作，不影响已有文件 - 如果用的是 NFS 或 Docker volume，chmod 可能被忽略，此时得靠宿主机或部署脚本统一修复
多个磁盘共用一个驱动，但想隔离根目录怎么办？
可以，而且很常用——比如用两个 local 磁盘分别存上传文件和日志，避免混在一起。
- 在
config/filesystems.php中定义两个磁盘，都设'driver' => 'local' - 但各自指定不同
root：一个用storage_path('app/uploads')，另一个用storage_path('app/logs') - 调用时明确指定磁盘名：
Storage::disk('uploads')->put(...)、Storage::disk('logs')->put(...) - 注意：
public磁盘的符号链接机制只管storage/app/public，其他local磁盘不能通过asset()直接访问，除非你手动建链接或走控制器输出
真正容易被忽略的是缓存层——S3 或 FTP 磁盘不做 CachedAdapter 包封装，每次 exists() 或 lastModified() 都发一次网络请求。这不是“能不能用”的问题，而是“会不会拖垮接口响应时间”的问题。
