Laravel项目部署cPanel生产环境后数据库上传报HTTP ERROR 500

• 先看Laravel日志：找到项目里的storage/logs/laravel.log文件，里面会有具体的错误详情，比如数据库连接失败、权限不足、文件上传限制等，这是排查500错误最直接的方式。
• 检查目录权限：确保storage和bootstrap/cache目录的权限设置正确，线上服务器一般设为755或775，并且目录所属用户组要和web服务器一致（比如cPanel里的nobody或www-data）。
• 核对**.env配置**：
  • 数据库配置项（DB_HOST、DB_DATABASE、DB_USERNAME、DB_PASSWORD）要和cPanel后台创建的数据库信息完全一致，注意主机可能不是localhost，有些服务商提供专属数据库地址。
  • 临时把APP_DEBUG设为true，这样能在页面看到具体错误（排查完记得改回false）。
• 检查文件上传限制：
  • 登录cPanel找到PHP配置，确认upload_max_filesize和post_max_size的数值足够，比如上传大文件时这两个值要大于文件大小。
  • 核对config/filesystems.php里的磁盘配置，比如public磁盘的根目录和权限是否正确。
• 验证数据库用户权限：cPanel里创建的数据库用户，要确保拥有该数据库的INSERT、UPDATE等写入权限，本地用root权限可能没问题，线上用户权限不足会导致写入失败。
• 清除Laravel缓存：通过cPanel的终端或SSH执行以下命令：

  php artisan config:cache
  php artisan cache:clear
  php artisan route:cache
  

  避免配置文件缓存导致的旧配置生效问题。
• 确认PHP版本：Laravel不同版本有最低PHP要求，比如Laravel 9需要PHP 8.0及以上，在cPanel的PHP选择器里检查版本是否符合项目要求。
• 检查CSRF令牌：表单提交时要正确携带CSRF令牌，比如在表单里加入@csrf指令，线上环境如果CSRF验证失败也会触发500错误。

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