上传文件后需用storage::url()（public磁盘）或temporaryurl()（s3）生成可访问url；public磁盘须先运行php artisan storage:link，文件存于storage/app/public/并映射为/storage/路径；local磁盘不支持url()，s3返回完整https地址。
上传文件后怎么拿到可访问的 URL
上传后的文件默认存在 storage/app/ 下，但这个路径不对外公开，直接拼接 URL 会 404。必须通过 laravel 的 Storage 门面生成有效链接。
关键点：不能用 realpath() 或手动拼 public/storage/xxx，要走 Storage::url()（仅对 public 磁盘有效）或 Storage::temporaryUrl()（S3/临时签名链接）。
- 如果用的是
public磁盘（推荐本地开发），先运行php artisan storage:link建立软链 -
Storage::disk('public')->put('avatars/user.jpg', $file)后，用Storage::disk('public')->url('avatars/user.jpg')得到/storage/avatars/user.jpg - 若磁盘是
local（默认），url()不可用，需改用response()->file()或自行映射到 public 目录
storage/app 和 public/storage 到底什么关系
storage/app/ 是真实写入路径；public/storage/ 是符号链接，指向 storage/app/public/。只有 public 磁盘下的文件才被允许通过 Web 访问。
常见误解：以为所有 storage/app/xxx 都能加 /storage/xxx 访问 —— 实际上只有 storage/app/public/ 下的内容才被软链暴露。
-
Storage::disk('public')->put('a.jpg', ...)→ 存到storage/app/public/a.jpg→ 可通过/storage/a.jpg访问 -
Storage::disk('local')->put('a.jpg', ...)→ 存到storage/app/a.jpg→ 无法直接 Web 访问 - 不要手动把文件 cp 到
public/目录下，绕过 Storage 会导致无法统一管理、缓存失效、测试环境不一致
为什么 Storage::url() 返回空或报错 “UrlGenerator not supported”
这是磁盘配置没开 URL 支持的典型表现，多见于自定义磁盘或用了 local 驱动却调用 url()。
检查 config/filesystems.php 中对应磁盘是否设置了 'url' => env('APP_URL')，且驱动为 public 或显式支持 URL 的驱动（如 s3）。
-
public磁盘默认配置含'url' => env('APP_URL').'/storage'，所以url()可用 -
local磁盘默认无url键，调用url()就抛异常 - 若要用
local磁盘又需要 URL，得手动加'url' => '/uploads'并确保该路径有对应路由或 nginx alias
生产环境用 S3 时路径和 URL 怎么处理
S3 没有“本地路径”概念，Storage::path() 在 S3 驱动下不可用（会报错），只能用 Storage::url() 或 Storage::temporaryUrl() 获取可访问链接。
注意：S3 的 url() 返回的是完整 HTTPS 地址（如 https://xxx.s3.amazonaws.com/xxx.jpg），而本地 public 磁盘返回的是相对路径（/storage/xxx.jpg）。前后端联调时容易因这个差异导致图片 404。
- 前端不应硬编码
/storage/前缀，应由后端 API 统一返回完整 URL 字段 - 临时签名链接（如上传私有文件）必须用
temporaryUrl()并传有效期，例如：Storage::disk('s3')->temporaryUrl('private.pdf', now()->addMinutes(5)) - 本地开发想模拟 S3 行为？建议统一用
url()，并在filesystems.php中为local磁盘配好url，避免条件分支
实际项目里最常出问题的，是混用磁盘类型 + 忘记软链 + 在 local 磁盘上调 url()，这三者叠加基本等于图片全挂。路径本身不复杂，但 Laravel 把「存储位置」「Web 可达性」「驱动抽象」分了三层，漏掉一层就断链。