必须将storage和bootstrap/cache目录归属设为phpEnv实际运行用户（如www:www），并配置Nginx使用$realpath_root解析SCRIPT_FILENAME、添加/storage alias映射，否则仍会报错。
phpEnv 下 Nginx 进程用户和 Laravel storage 权限必须对齐
phpEnv 默认用 www 用户运行 Nginx 和 PHP-FPM，不是 www-data 或 nginx。如果你照搬 Ubuntu/CentOS 的 chown 命令（比如 chown -R www-data:www-data storage/），Laravel 依然会报 “Permission denied” 写入日志或缓存失败——因为进程根本不是那个用户。
确认方式：打开 phpEnv 对应 PHP 版本的 FPM 配置文件，路径类似 /phpenv/php/82/etc/php-fpm.d/www.conf（82 表示 PHP 8.2），查找 user = 和 group = 行。常见值是 user = www、group = www，极少数自定义为 www1 等。
- 必须用实际配置的用户名执行
chown -R www:www storage/ bootstrap/cache/ - 如果改过 php-fpm 配置但没重启服务，权限仍无效；执行
phpenv restart或手动重启对应 PHP-FPM 实例 - 不要用
chmod 777—— 它掩盖问题，且让storage/logs/可被任意写入，有安全风险
Nginx 配置里不能漏掉 fastcgi_param SCRIPT_FILENAME
phpEnv 的 Nginx 默认配置通常不包含完整 Laravel 兼容参数，尤其容易缺失或写错 SCRIPT_FILENAME，导致 storage/app/public 下的文件虽有权限，却无法通过 /storage/xxx.jpg 正确路由到物理路径，表现为 404 或直接下载空白文件。
在站点对应的 Nginx 配置中（如 /phpenv/nginx/vhost/your-site.conf），确保 location ~ \.php$ 块内包含：
立即学习“PHP免费学习笔记（深入）”；
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
而不是旧式写法 $document_root$fastcgi_script_name —— 因为 Laravel 的 public 目录可能被软链或挂载，$document_root 无法解析真实路径，$realpath_root 才能穿透符号链接定位到 storage/app/public 的实际位置。
- 改完配置必须执行
phpenv nginx reload，不是 restart - 若用了
alias指向 public 目录，$realpath_root依然有效；但root+try_files是更稳的组合
storage:link 生成的符号链接必须由 Nginx 用户可读
php artisan storage:link 在 public/storage 创建指向 storage/app/public 的软链，但这个软链本身和目标目录都得对 Nginx 用户（即 www）可读。常见错误是：软链文件权限为 600 或属主是部署用户，导致 Nginx 无法跟随链接。
检查命令：
ls -l public/storage
输出应类似 lrwxrwxrwx 1 www www 21 Apr 25 10:22 public/storage -> ../storage/app/public。如果不是，修复方式：
- 删掉旧链接：
rm public/storage - 切到 web 用户身份再建（避免属主错）：
sudo -u www php artisan storage:link - 或者建完立刻修正：
sudo chown www:www public/storage && sudo chmod 777 public/storage（仅软链文件本身，不是目录）
子目录（如 storage/app/public/images）访问 404 的真正原因
即使 public/storage 软链正常、权限正确，访问 /storage/images/logo.png 仍 404，大概率不是权限问题，而是 Nginx 没启用 follow_symlinks 或未显式允许该路径被 serve。
在站点 Nginx 配置的 server 块顶部添加：
location /storage {
alias /path/to/your/laravel/storage/app/public;
expires 1y;
add_header Cache-Control "public, immutable";
}
注意：alias 后路径必须是绝对路径，且结尾不带斜杠；/storage 请求会被映射到该目录下，不再依赖软链。
- 不要用
root替代alias，否则路径拼接错误，返回 403 或 404 - 如果项目根目录在
/www/wwwroot/myapp，那alias值就是/www/wwwroot/myapp/storage/app/public - 这个配置比依赖
storage:link更可靠，尤其在 phpEnv 这类多版本共存环境中
alias 和 fastcgi_param 的路径处理逻辑不同，一个管静态资源，一个管 PHP 脚本路由，两者权限校验点也不同——这是最常被混为一谈、反复踩坑的地方。 
