服务器500内部错误解决方法

# 终端一：同时挂 Nginx 与 PHP-FPM（或你的应用）日志
sudo tail -f /var/log/nginx/error.log /var/log/php8.3-fpm.log

# 终端二：复现请求
curl -i https://www.example.com/error-page

# systemd 管理的服务：查最近 10 分钟的错误级日志
sudo journalctl -xe -u nginx --since "10 min ago"
sudo journalctl -u php8.3-fpm -p err --since "30 min ago" --no-pager

# 配置语法必须先排除（语法错会以 500 或启动失败的形式暴露）
sudo nginx -t
sudo apachectl configtest

; 生产环境常态：不向浏览器输出错误，只写日志
display_errors         = Off
display_startup_errors = Off
log_errors             = On
error_reporting        = E_ALL & ~E_DEPRECATED & ~E_STRICT
error_log              = /var/log/php8.3-fpm.log

catch_workers_output = yes
php_admin_flag[log_errors] = on
php_admin_value[error_log] = /var/log/php-fpm/www-error.log
slowlog = /var/log/php-fpm/www-slow.log
request_slowlog_timeout = 5s

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

    # 临时调试：仅对该站点打开错误显示，排查完务必删除
    fastcgi_param PHP_VALUE "display_errors=On
error_reporting=E_ALL
log_errors=On
error_log=/var/log/php-fpm/debug-site.log";
}

# 语法检查（不上线就能发现 parse error）
php -l /var/www/html/index.php

# 已加载扩展，排查 Class not found / 扩展缺失
php -m | grep -iE "pdo|mysql|redis|gd|mbstring"

# Composer 依赖与自动加载
composer install --no-dev --optimize-autoloader
composer dump-autoload -o

# 手动重置 OPcache（代码更新后仍报旧错时）
php -r 'opcache_reset();'
sudo systemctl reload php8.3-fpm

# systemd 服务：最近 200 行含堆栈
sudo journalctl -u myapp -n 200 --no-pager

# nohup 启动的 jar：看重定向输出
tail -n 300 /opt/myapp/nohup.out | grep -A 30 -i "exception\|caused by"

# 进程还在但响应 500：抓线程栈看是否卡死或线程池打满
jps -l
jstack -l  > /tmp/jstack.txt
jstat -gcutil  1000 5

# 连接池耗尽的典型日志
grep -i "HikariPool\|Connection is not available" /var/log/myapp/app.log | tail -20

# gunicorn：systemd 管理的直接查 journal
sudo journalctl -u gunicorn -n 200 --no-pager

# 或启动时显式指定日志文件
gunicorn -w 4 -b 127.0.0.1:8000 myapp.wsgi:application \
  --error-logfile /var/log/gunicorn/error.log \
  --access-logfile /var/log/gunicorn/access.log \
  --capture-output

# uWSGI
tail -f /var/log/uwsgi/app.log

# 依赖与配置自检
python -m py_compile app.py
pip install -r requirements.txt
python manage.py check --deploy      # Django 部署检查，会提示 ALLOWED_HOSTS 等问题

# 空间与 inode 双查（inode 耗尽会报 No space left on device 但 df -h 显示有空间）
df -h
df -i

# 快速定位大目录
du -sh /var/log/* 2>/dev/null | sort -rh | head -10
du -x -h --max-depth=1 / 2>/dev/null | sort -rh | head -10

# 清空（而非删除）被进程占用的大日志文件
sudo truncate -s 0 /var/log/nginx/access.log
sudo journalctl --vacuum-size=500M

# 权限与属主（PHP 报 failed to open stream 时必查）
ps -o user,cmd -C php-fpm8.3
namei -l /var/www/html/runtime/cache
sudo chown -R www-data:www-data /var/www/html/runtime
find /var/www/html -type d -exec chmod 755 {} \;
find /var/www/html -type f -exec chmod 644 {} \;