本地部署GitHub Laravel项目遇XAMPP/WAMP 500服务器错误求助

• 优先查看Laravel错误日志：这是定位问题最直接的方式，日志文件位于项目根目录的storage/logs/laravel.log，里面会记录500错误的具体原因（比如数据库连接失败、权限不足、依赖缺失等）。

• 检查目录权限：Laravel需要storage和bootstrap/cache目录具备写入权限。在Windows环境下，右键这两个文件夹，选择「属性」-「安全」，给当前用户添加「写入」权限；如果用Git Bash等终端，可执行命令：

  chmod -R 775 storage bootstrap/cache
  

• 确认.env文件配置：

  1. 复制项目根目录的.env.example文件并重命名为.env；
  2. 在.env中配置正确的数据库连接信息（DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD）；
  3. 执行php artisan key:generate生成APP_KEY，没有这个密钥Laravel会直接抛出500错误。

• 完善虚拟主机配置：你的当前配置缺少目录权限规则，导致.htaccess可能无法生效，修改为以下配置：

  <VirtualHost *:80>
      ServerName storemanager2.com
      DocumentRoot "C:/xampp/htdocs/storemanager/public/"
  
      <Directory "C:/xampp/htdocs/storemanager/public/">
          AllowOverride All
          Require all granted
      </Directory>
  </VirtualHost>
  

  同时检查系统hosts文件（路径：C:\Windows\System32\drivers\etc\hosts）是否添加了映射：

  127.0.0.1 storemanager2.com
  

• 检查PHP扩展是否开启：Laravel依赖mbstring、openssl、pdo_mysql等扩展，打开XAMPP的php.ini文件，确保这些扩展前的注释符号;已被移除，之后重启Apache服务。

• 清除项目缓存：执行以下命令清除配置、路由和缓存文件：

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

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