laravel storage多磁盘配置需确保driver、root（local专用）、visibility、url逻辑自洽：local磁盘须设真实可写root路径，public磁盘visibility必须为'public'且url匹配php artisan storage:link生成的/public/storage路径，s3/oss磁盘禁用root并动态加载凭据，新增磁盘名仅限小写字母与下划线。
Storage 多磁盘配置不是“配完就能用”，而是必须明确每个磁盘的用途、可见性、路径映射和访问方式——否则上传成功却 404、导出失败、临时文件堆积在错误位置，都是常见后果。
config/filesystems.php 中 disks 数组怎么填才不踩坑
关键不是写多少磁盘，而是每个磁盘的 driver、root（仅 local）、visibility、url 是否逻辑自洽：
-
local磁盘必须指定root，且该路径要真实存在、Web 进程有读写权限；别直接写/var/www/storage/app，用storage_path('app')动态生成 -
public磁盘的visibility必须是'public'，且url要匹配你运行过php artisan storage:link后的公开路径（即APP_URL . '/storage'） -
s3或oss磁盘不能设root，否则 Flysystem 会报错；凭据字段如key/secret/bucket必须通过env()加载，禁止硬编码 - 新增磁盘名（如
'backup'）不能和已有磁盘重名，且不要用连字符或大写字母，只用小写字母+下划线
Storage::disk('xxx')->put() 为什么文件存对了但 URL 访问不到
这是最常被忽略的路径错位问题：存文件用的磁盘，和生成 URL 的磁盘，必须是同一套可见性与 URL 映射逻辑。
- 用
public磁盘存储 → 必须配合asset('storage/' . $path)或Storage::disk('public')->url($path)，不能用Storage::url($path)（它走默认磁盘，可能不是 public） - 用
local磁盘存储 → 文件物理存在但无 Web 可访问路径，Storage::url()会返回空或错误 URL，必须走控制器响应或代理下载 - 用
s3磁盘存储 →Storage::url()返回的是预签名 URL 或公开 bucket 域名，需确认visibility设为'public'且 bucket 权限允许匿名 GET
Laravel-Excel 导出到 s3 时临时文件卡在 local 是为什么
因为 Laravel-Excel 默认只把最终文件发到目标磁盘，中间生成的临时 CSV/XLSX 仍走 temporary_files.local_path，而这个路径默认指向 storage_path('framework/cache/laravel-excel') —— 它属于 local 磁盘，和你的 s3 导出无关。
- 若部署在多服务器环境（如负载均衡），必须把
temporary_files.local_path改成共享存储路径（如 NFS 挂载点），或干脆设为内存临时目录（sys_get_temp_dir()） - 要让临时文件也走远程磁盘，得显式配置
temporary_files.remote_disk => 's3'，并确保该磁盘支持writeStream和readStream - 队列任务中使用 Excel 导出时，
force_resync_remote应设为true，否则临时文件可能因网络延迟未同步就触发下载
Storage::download() 在 s3 磁盘上始终 404 怎么办
Storage::download() 本质是调用 readfile()，只认本地文件系统路径。对 s3、oss 这类远程驱动，它根本找不到物理文件。
- 正确做法：先用
Storage::disk('s3')->get($path)拉取内容，再用response()->streamDownload(...)流式返回，避免内存爆满 - 如果文件较大（>2MB），绝不要用
Storage::disk('s3')->download()—— 它会试图把整个文件 load 到内存再输出，PHP 内存限制直接崩 - 中文文件名必须手动设置
Content-Disposition头，Storage::download()的第二个参数只处理 ASCII 名，中文会乱码或被截断
public，日志归档用 local，报表导出临时文件用 sys_get_temp_dir()，最终结果存 s3。混用或默认兜底，迟早翻车。
