在 Ubuntu 上部署 Laravel 时，权限设置的核心是：让 Web 服务进程对需要写入的目录具备读写权限，同时避免对代码目录过度放权。下面给出可直接执行的规范做法与排错要点。
一、前置确认
- 确认 Web 服务运行用户与组：常见为 www-data（Nginx/Apache 在 Debian/Ubuntu 上的默认运行用户）。
命令示例：
- ps -ef | grep php 或 ps -ef | grep nginx
- 若使用 PHP-FPM，查看 /etc/php/*/fpm/pool.d/www.conf 中的 user/group 配置。
- 确认项目路径（示例：/var/www/laravel），后续命令均以此路径为占位，请替换为你的实际路径。
- 原则：不要使用 777；优先通过“用户/组所有权 + 最小权限”来满足运行需求。
二、推荐的权限方案 A 服务器为所有者（便于隔离）
- 将项目目录所有权交给 Web 服务用户（如 www-data）：
sudo chown -R www-data:www-data /var/www/laravel
- 设置默认权限：
- 文件：644（所有者读写，组与其他只读）
- 目录：755（所有者读写执行，组与其他读执行）
命令示例：
sudo find /var/www/laravel -type f -exec chmod 644 {} ;
sudo find /var/www/laravel -type d -exec chmod 755 {} ;
- 为需要写入的目录赋予 Web 服务用户组并开放权限：
sudo chgrp -R www-data /var/www/laravel/storage /var/www/laravel/bootstrap/cache
sudo chmod -R ug+rwx /var/www/laravel/storage /var/www/laravel/bootstrap/cache
- 若需要通过 FTP/SFTP 修改文件，将你的系统用户加入 www-data 组：
sudo usermod -a -G www-data $USER
提示：加入组后需重新登录或重启会话以生效。
三、推荐的权限方案 B 开发者为所有者（便于日常编辑）
- 将项目所有权设为“开发者用户:Web 服务组”：
sudo chown -R $USER:www-data /var/www/laravel
- 设置默认权限（比方案 A 略宽，便于编辑器与部署工具）：
- 文件：664（所有者与组读写，其他只读）
- 目录：775（所有者与组读写执行，其他读执行）
命令示例：
sudo find /var/www/laravel -type f -exec chmod 664 {} ;
sudo find /var/www/laravel -type d -exec chmod 775 {} ;
- 仍需对写入目录显式授权：
sudo chgrp -R www-data /var/www/laravel/storage /var/www/laravel/bootstrap/cache
sudo chmod -R ug+rwx /var/www/laravel/storage /var/www/laravel/bootstrap/cache
- 敏感文件最小化权限：
sudo chmod 600 /var/www/laravel/.env
sudo chmod 644 /var/www/laravel/.htaccess
说明：方案 B 更适合本地/团队开发环境，兼顾可维护性与安全性。
四、常见故障排查
- 出现 “Failed to open stream: Permission denied”（如无法写入 storage/logs/laravel.log）：
- 确认运行用户是 www-data（或你的 FPM/HTTP 配置中的用户）。
- 检查并修复目录/文件所有权与权限：
sudo chown -R www-data:www-data /var/www/laravel/storage /var/www/laravel/bootstrap/cache
sudo chmod -R ug+rwx /var/www/laravel/storage /var/www/laravel/bootstrap/cache
- 若日志文件被 root 创建导致不可写：
sudo chown www-data:www-data /var/www/laravel/storage/logs/laravel.log
sudo chmod 664 /var/www/laravel/storage/logs/laravel.log
- 切勿为解决问题而将 PHP 以 root 运行，这会引入严重安全风险。
- 使用定时任务（Laravel Scheduler）写入日志/缓存失败：
- 确保 cron 以与 Web 服务相同的用户运行（如：sudo crontab -u www-data -e），避免以 root 生成 root 属主文件。
五、安全与维护要点
- 避免使用 777；优先通过用户/组与最小权限实现功能。
- 将你的登录用户加入 www-data 组后，如需新文件默认继承组写权限，可在项目根目录设置 setgid：
sudo chmod g+s /var/www/laravel
- 修改权限或组后，必要时重启相关服务（如 sudo systemctl restart php8.1-fpm nginx）以确保生效。
- 定期检查 storage/logs、bootstrap/cache 等目录的属主与权限，防止因部署脚本或手动操作导致权限漂移。