Laravel生产环境无法创建可锁定缓存文件权限问题求助

根本原因 #

问题核心是缓存目录的部分子文件夹被root用户创建，导致运行Laravel的www-data用户没有读写权限。常见触发场景包括：

• 用root身份执行过php artisan命令（比如缓存生成、迁移）
• 部署脚本以root权限运行，自动生成了缓存文件/目录
• 服务器上的其他root进程意外修改了缓存目录的属主

紧急修复步骤 #

1. 递归修正storage目录属主
   把整个storage目录及子内容的属主改回www-data：

   sudo chown -R www-data:www-data /var/www/html/storage
   

2. 设置正确的权限位
   确保目录有可执行权限（允许进入），文件有读写权限：

   sudo chmod -R 755 /var/www/html/storage
   

3. 清理缓存（用www-data用户执行）
   避免用root清缓存，防止再次出现权限问题：

   sudo -u www-data php artisan cache:clear
   sudo -u www-data php artisan config:clear
   

长期预防方案 #

• 所有Laravel操作使用www-data用户：不管是执行artisan命令还是composer安装，都用sudo -u www-data前缀，比如：

  sudo -u www-data php artisan config:cache
  sudo -u www-data composer install --no-dev
  

• 部署脚本加入权限校验：在部署流程末尾添加自动修正storage权限的命令，避免每次部署后手动处理
• 切换缓存驱动（可选）：如果服务器支持，改用Redis或Memcached作为缓存驱动，彻底避开文件权限类问题

排查方向 #

• 检查服务器的操作日志，确认近期是否有root用户执行过Laravel相关命令
• 查看storage/logs/laravel.log的详细日志，定位触发缓存创建的具体请求或操作
• 确认Web服务器（Nginx/Apache）的运行用户确实是www-data（可通过ps aux | grep nginx或ps aux | grep apache2验证）

内容的提问来源于stack exchange，提问作者idan