根本原因是PHP CLI进程用户对目标目录无权限，需确认当前用户与storage属主一致、逐级修复目录x权限和文件r权限、加组授权供Web用户读取，并绕过macOS Gatekeeper/SIP限制。
执行 Laravel 命令行（如 php artisan cache:clear、storage:link 或自定义命令）时出现“Permission denied”“failed to open stream”或“mkdir(): Permission denied”，根本原因不是代码写错，而是 PHP CLI 进程运行用户对目标目录或文件没有对应权限。macOS 和 Linux 环境下尤其常见，需分层排查属主、组、目录执行位和 SELinux/AppArmor 等限制。
确认 CLI 进程实际运行用户
Laravel 命令由当前终端用户启动，但最终操作文件的是 PHP CLI 进程——它以你当前 shell 用户身份运行（不是 web 服务器用户）。例如你在终端用 john 用户执行 php artisan config:cache，那所有文件写入动作都以 john 身份进行。
- 运行
whoami查看当前用户； - 运行
ls -ld storage bootstrap/cache，对比输出的属主（第一列）是否与whoami一致； - 若不一致（比如显示
root:root），说明之前用sudo执行过命令，导致部分目录被 root 占据，后续普通用户无法写入。
修复 storage 及其子目录权限链
storage 是 Laravel 最常出错的目录，日志、缓存、session 全依赖它。权限问题往往不是“不够宽”，而是“不连续”——某一层目录缺 x（执行）权限，就会阻断整个路径访问。
- 先重置属主：
sudo chown -R $USER:staff storage bootstrap/cache（macOS 默认组是staff；Linux 常为www-data或nginx，请按实际替换）； - 确保所有目录可进入：
find storage bootstrap/cache -type d -exec chmod 755 {} \;； - 确保日志和缓存文件可写：
find storage/logs storage/framework/cache data -type f -exec chmod 644 {} \;； - 特别注意
storage/logs/laravel.log：如果它已存在且属主是 root，直接rm storage/logs/laravel.log，再让 Artisan 重建（避免残留权限污染）。
处理 public/storage 软链接与 Web 用户读取冲突
CSS/JS 加载失败、图片 403，常因 public/storage → ../storage/app/public 链接虽存在，但 Web 服务器（如 nginx 或 Apache）用户无法读取 storage/app/public 内容。
- 检查链接有效性：
ls -la public/storage，应显示指向../storage/app/public； - 模拟 Web 用户读取：
sudo -u www-data ls -l storage/app/public/css/（Linux）或sudo -u _www ls -l storage/app/public/css/（macOS）； - 若报错，说明 Web 用户对该路径无
r-x权限。此时不要改$USER的权限，而要加组授权：sudo chgrp -R www-data storage/app/public，再chmod -R g+rx storage/app/public； - 最后补软链接：
php artisan storage:link（仅当链接不存在或失效时运行）。
避开系统级保护机制干扰
macOS 下还可能触发 SIP（系统完整性保护）或 Gatekeeper，表现为 artisan 文件被标“已损坏”，或 php 调用系统路径失败。
- 运行
ls -l artisan，确认有x权限（如-rwxr-xr-x）；若无，执行chmod +x artisan； - 若点击运行仍弹窗提示“已损坏”，右键
artisan→ “打开”，在弹窗中点“打开”一次即可解除 Gatekeeper 标记； - 检查 PHP 路径：
which php应输出 Homebrew 路径（如/opt/homebrew/bin/php），而非/usr/bin/php；若错误，用brew link php@8.2切换并重开终端； - 禁用 Xdebug 干扰：
php -d xdebug.mode=off artisan list，能正常输出即说明 Xdebug 的调试模式导致 CLI 卡住。
