如何在AWS EC2 Ubuntu Apache2环境调试Laravel项目HTTP ERROR 500

1. 先定位500错误的具体原因 #

首先查看Apache的错误日志，这是排查500错误最直接的方式：

sudo tail -n 20 /var/log/apache2/error.log

日志内容会明确告诉你是权限问题、配置错误还是Laravel内部代码问题。

2. 修复Laravel核心目录权限 #

Laravel的storage和bootstrap/cache目录需要Apache用户（Ubuntu下为www-data）的写入权限，这是500错误的常见诱因：

# 给关键目录添加写入权限
sudo chmod -R 775 /home/ubuntu/my-laravel-oproject-folder/storage
sudo chmod -R 775 /home/ubuntu/my-laravel-oproject-folder/bootstrap/cache

# 将目录所有者设置为Apache用户
sudo chown -R www-data:www-data /home/ubuntu/my-laravel-oproject-folder

3. 修正Apache目录配置 #

打开apache2.conf检查你添加的目录配置段：

sudo nano /etc/apache2/apache2.conf

确保<Directory /home/ubuntu>的配置如下（重点是AllowOverride All，否则Laravel的.htaccess无法生效）：

<Directory /home/ubuntu>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

4. 启用Apache Rewrite模块 #

Laravel依赖Rewrite模块处理路由，若未启用会导致路由失效或500错误：

sudo a2enmod rewrite
sudo service apache2 restart

5. 验证站点配置文件 #

打开000-default.conf确认DocumentRoot和对应目录配置：

sudo nano /etc/apache2/sites-available/000-default.conf

确保内容包含正确的根目录和权限配置：

DocumentRoot /home/ubuntu/my-laravel-oproject-folder/public

<Directory /home/ubuntu/my-laravel-oproject-folder/public>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

修改后重启Apache：

sudo service apache2 restart

6. 检查Laravel环境配置 #

确保.env文件存在且配置正确：

# 若没有.env文件，从示例文件复制
cp /home/ubuntu/my-laravel-oproject-folder/.env.example /home/ubuntu/my-laravel-oproject-folder/.env

# 设置.env文件权限（避免敏感信息泄露）
sudo chmod 644 /home/ubuntu/my-laravel-oproject-folder/.env
sudo chown www-data:www-data /home/ubuntu/my-laravel-oproject-folder/.env

# 生成Laravel应用密钥
cd /home/ubuntu/my-laravel-oproject-folder
sudo php artisan key:generate

如果执行完以上步骤仍有问题，将第一步获取的错误日志内容提供出来，即可精准定位剩余问题。

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