Laravel部署后如何修改文件上传路径为自定义路径？

本文共计1031个文字，预计阅读时间需要5分钟。

phpfunction storage_path(){ return base_path('storage');}

常见错误是直接在 config/filesystems.php 里改 'root' => storage_path('app') 这一行，以为改了这里就全局生效。其实这只是影响 Storage 门面的默认磁盘行为，request()->file()->store() 等上传方法仍可能走默认配置或硬编码路径。

• 真正要动的是 config/filesystems.php 中对应磁盘的 'root' 配置项（比如 'local' 或自定义磁盘）
• 如果用 storeAs('uploads', $name)，它默认写入 storage/app/uploads/，所以得确保底层磁盘 root 已指向新位置
• 别漏掉 storage/app/.gitignore 和权限问题：新路径需保证 web 用户可写，且不能意外暴露（比如把 /var/www/uploads 直接放到 webroot 下）

public disk 上传后文件 URL 怎么不 404

很多人把文件存到 /var/www/myapp/uploads/，但访问 https://site.com/uploads/foo.jpg 报 404——这不是 Laravel 的问题，是 Web 服务器没映射好静态路径。

Laravel 的 public 磁盘默认 root 是 public_path('storage')，也就是 public/storage 这个软链接。如果你改了上传目标为外部路径，Storage::url() 仍会拼出 /storage/xxx，但这个 URL 对应的物理路径必须由 Nginx/Apache 显式指向。

• Nginx 需加 location /uploads { alias /var/www/myapp/uploads/; }（注意末尾斜杠）
• Apache 要用 Alias /uploads "/var/www/myapp/uploads" + <Directory> 开放权限
• 避免用 symlink 命令硬链到 public/ 下：路径一变就断，且容易被 git 误提交

上传时用 Storage::disk('custom')->put() 还是 move()？

用 move() 是最危险的直连操作——它绕过所有 Laravel 文件系统抽象，直接调用 PHP 的 move_uploaded_file()，不经过磁盘驱动、不触发事件、不记录日志、也不做路径安全校验。

正确做法是统一走 Storage 门面，哪怕你配了个自定义磁盘：

Storage::disk('uploads')->put($path, file_get_contents($request->file('avatar')));

或者更推荐流式写入（省内存）：

Storage::disk('uploads')->put($path, $request->file('avatar')->get());

• store() 和 storeAs() 内部也是调用 put()，但自动处理文件名和目录创建，适合简单场景
• 如果磁盘配置里 'driver' => 'local'，put() 最终就是 file_put_contents()，性能无差别
• 别在 storeAs() 的第一个参数里写绝对路径，它只接受相对路径（如 'images/avatar.jpg'），否则会拼到 root 后面变成双重路径

APP_ENV=production 下上传失败但本地正常？

典型现象是 file_put_contents(/new/path/xxx): failed to open stream: Permission denied，根本原因不是 Laravel，是 Linux 权限模型在起作用。

生产环境的 PHP-FPM 进程通常以 www-data 或 nginx 用户运行，而部署脚本常用 root 或开发者账户执行，导致新目录 owner 是 root，PHP 进程没写权。

• 上传前确保目录存在且属组正确：sudo chown -R :www-data /var/www/myapp/uploads
• 设置 SGID 位让新建文件继承组：sudo chmod -R g+s /var/www/myapp/uploads
• 别用 chmod 777，这是临时止痛药，上线后会被安全扫描直接标红
• 如果用 Supervisor 管理队列，记得检查队列 worker 进程的用户身份是否和 Web 进程一致

路径本身没有魔法，关键是权限、Web 服务器映射、以及是否所有环节（上传、存储、读取）都落在同一套路径约定里。漏掉任意一环，文件就“消失”了。