webman目录权限不足报错需五步解决：一查web服务用户并chown归属；二设目录755/文件644，可写目录单独775；三将.env设为600；四处理selinux上下文或只读挂载；五检查open_basedir是否包含storage等路径。
页面空白、500错误、日志写不进、缓存清不掉——这些症状背后，90%是storage和bootstrap/cache目录权限没对齐Web服务器用户，而不是代码或配置出错。
先确认Web服务器实际运行用户
别猜，直接查。在终端进入项目根目录，执行：ps aux | grep -E '(php-fpm|nginx|httpd|apache)' | grep -v grep。重点看user字段：Ubuntu/Debian常见为www-data，CentOS/RHEL多为nginx或apache，宝塔面板默认是www，Mac Valet下是_www。
这一步漏掉，后面所有chown都白做——你给www-data赋权，结果PHP-FPM跑在nginx用户下，照样拒绝写入。
精准设置storage与bootstrap/cache所有权
进入项目根目录：cd /your/laravel/project/path。
执行命令（请将www替换成你上一步确认的真实用户）：sudo chown -R www:www storage/ bootstrap/cache/。
【漏掉bootstrap/cache/会导致Laravel启动失败，连错误日志都写不出来】。很多教程只提storage，但Laravel启动第一秒就要往bootstrap/cache/config.php写缓存，这里卡住就直接返回空响应。
设置合理权限并启用组继承
执行：sudo chmod -R 755 storage/ bootstrap/cache/。
再补关键一步：sudo chmod g+s storage/ bootstrap/cache/。这会让后续Laravel自动生成的子目录（如storage/framework/views、storage/logs）自动继承组写权限，避免手动反复chmod。
775不是必须，755在单用户生产环境更稳妥；777绝对禁止——它等于把服务器后门钥匙挂在门口。
SELinux或macOS特殊处理
方法一（CentOS/RHEL启用SELinux时）：sudo semanage fcontext -a -t httpd_sys_rw_content_t "/your/laravel/project/storage(/.*)?" → sudo restorecon -Rv /your/laravel/project/storage。
方法二（macOS + Valet/Nginx）：确认php-fpm用户是_www后，执行sudo chown -R $USER:_www /your/laravel/project → sudo chmod -R 775 storage/ bootstrap/cache/ → sudo chmod g+s storage/ bootstrap/cache/。
注意：macOS用户家目录默认禁止其他用户访问，config/filesystems.php中local磁盘的root值必须用storage_path('app')动态路径，不能硬写/Users/yourname/storage/app。
验证写入能力是否真正生效
第一步：重启对应PHP服务（不是Nginx/Apache，是PHP-FPM进程本身）。
第二步：运行测试命令：php -r "file_put_contents('storage/test.txt', 'ok'); echo file_get_contents('storage/test.txt');"。
第三步：若输出ok，说明权限已通；若报错，检查上一步的用户名是否拼错、路径是否进错目录、SELinux是否拦截。
第四步：删掉测试文件：rm storage/test.txt。
