رفع خطای 500 Internal Server Error: راهنمای گام‌به‌گام عیب‌یابی

خطای 500 چیست و چرا رخ می‌دهد؟

خطای 500 Internal Server Error یکی از عمومی‌ترین خطاهای HTTP است که نشان می‌دهد سرور با یک مشکل داخلی مواجه شده، اما نمی‌تواند جزئیات دقیق آن را به مرورگر نشان دهد. این خطا می‌تواند ناشی از مشکلات مختلفی باشد: از یک فایل .htaccess خراب گرفته تا کمبود حافظه PHP یا سطح دسترسی اشتباه فایل‌ها. برخلاف خطاهای 404 یا 403، رفع خطای 500 نیاز به بررسی سیستماتیک دارد.

در این مقاله، یک مسیر گام‌به‌گام برای عیب‌یابی و رفع این خطا ارائه می‌دهیم. فرقی نمی‌کند سایت شما روی هاست اشتراکی، VPS یا سرور اختصاصی اجرا شود؛ مراحل زیر تقریباً در همه محیط‌ها کاربرد دارند. اگر از خدمات هاستینگ استفاده می‌کنید، شرکت‌هایی مانند سرورنت ابزارهای مدیریتی مناسبی برای دسترسی به لاگ‌ها و تنظیمات PHP در اختیار شما می‌گذارند.

گام اول: بررسی لاگ خطا (Error Log)

مهم‌ترین ابزار برای رفع خطای 500، لاگ خطای سرور است. بدون دیدن لاگ، مثل این است که در تاریکی به دنبال سوزن بگردید. بسته به محیط میزبانی، لاگ‌ها در مکان‌های مختلفی ذخیره می‌شوند.

دسترسی به لاگ در cPanel

اگر از cPanel استفاده می‌کنید:

1. وارد بخش Error Log در بخش Metrics شوید.
2. آخرین خطاها را بررسی کنید. معمولاً خطاهای مربوط به PHP یا Apache با timestamp مشخص ثبت می‌شوند.
3. به دنبال خطاهایی با عبارت PHP Fatal error یا Internal Server Error بگردید.

دسترسی به لاگ در سرورهای لینوکسی (SSH)

اگر به سرور دسترسی SSH دارید، می‌توانید لاگ‌ها را با دستورات زیر بررسی کنید:

# لاگ Apache (در توزیع‌های مبتنی بر Debian/Ubuntu)
tail -100 /var/log/apache2/error.log

# لاگ Apache (در توزیع‌های مبتنی بر RHEL/CentOS)
tail -100 /var/log/httpd/error_log

# لاگ Nginx
tail -100 /var/log/nginx/error.log

دستور tail -100 آخرین 100 خط لاگ را نشان می‌دهد. اگر خطا زیاد است، می‌توانید از grep برای فیلتر کردن استفاده کنید:

grep "500" /var/log/apache2/error.log | tail -20

فعال‌سازی نمایش خطا در PHP (موقت)

گاهی لاگ سرور خالی است یا دسترسی ندارید. در این موارد می‌توانید با افزودن کد زیر به فایل wp-config.php (در وردپرس) یا فایل اصلی برنامه، خطاها را در مرورگر ببینید:

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

نکته مهم: این کار را فقط موقت انجام دهید و پس از رفع خطا حتماً کد را حذف کنید، زیرا نمایش خطاها در محیط تولید (production) یک خطر امنیتی است.

گام دوم: بررسی فایل .htaccess

فایل .htaccess یکی از رایج‌ترین دلایل خطای 500 است. یک اشتباه تایپی کوچک در قوانین بازنویسی (rewrite rules) یا دستورات غیرمجاز می‌تواند سرور را از کار بیندازد.

تست با غیرفعال کردن موقت htaccess

ساده‌ترین راه برای تشخیص این است که فایل .htaccess را به طور موقت تغییر نام دهید:

1. از طریق FTP یا فایل‌منیجر cPanel به ریشه سایت (public_html) بروید.
2. فایل .htaccess را به .htaccess_old تغییر نام دهید.
3. سایت را مجدداً بارگذاری کنید. اگر خطا برطرف شد، مشکل از htaccess است.

اگر سایت کار کرد، می‌توانید یک فایل .htaccess جدید و تمیز ایجاد کنید. برای وردپرس، محتوای پیش‌فرض زیر را قرار دهید:

# BEGIN WordPress
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress

اشتباه رایج: دستورات غیرمجاز در htaccess

برخی دستورات Apache مانند php_value یا php_flag فقط در فایل httpd.conf یا vhost مجاز هستند و در htaccess باعث خطای 500 می‌شوند. اگر از دستورات PHP در htaccess استفاده کرده‌اید، آنها را به فایل php.ini یا user.ini منتقل کنید.

گام سوم: بررسی سطح دسترسی فایل‌ها و پوشه‌ها

سطح دسترسی (permissions) نادرست یکی دیگر از دلایل رایج خطای 500 است. اگر PHP نتواند فایلی را بخواند یا بنویسد، خطای داخلی رخ می‌دهد.

سطح دسترسی استاندارد

• فایل‌ها: 644 (rw-r--r--)
• پوشه‌ها: 755 (rwxr-xr-x)
• فایل‌های اجرایی مانند wp-config.php: 600 یا 640

برای اصلاح دسترسی‌ها از طریق SSH می‌توانید از دستورات زیر استفاده کنید:

# اصلاح دسترسی فایل‌ها به 644
find /path/to/site -type f -exec chmod 644 {} \;

# اصلاح دسترسی پوشه‌ها به 755
find /path/to/site -type d -exec chmod 755 {} \;

اگر از FTP استفاده می‌کنید، در نرم‌افزارهایی مانند FileZilla می‌توانید با کلیک راست روی فایل‌ها و انتخاب File Permissions دسترسی را تغییر دهید.

مالکیت فایل‌ها (Ownership)

گاهی دسترسی‌ها درست است اما مالکیت فایل اشتباه است. در هاست‌های اشتراکی معمولاً کاربر nobody یا www-data باید مالک فایل‌ها باشد. اگر از طریق SSH دسترسی دارید:

chown -R www-data:www-data /path/to/site

توجه: نام کاربر و گروه ممکن است در توزیع‌های مختلف متفاوت باشد (مثلاً apache در CentOS).

گام چهارم: بررسی محدودیت حافظه PHP

کمبود حافظه PHP (memory limit) یکی از دلایل پنهان خطای 500 است. وقتی یک اسکریپت PHP حافظه بیشتری از حد مجاز مصرف کند، سرور خطای داخلی برمی‌گرداند.

افزایش حافظه PHP در wp-config.php (وردپرس)

اگر از وردپرس استفاده می‌کنید، خط زیر را به فایل wp-config.php اضافه کنید:

define('WP_MEMORY_LIMIT', '256M');

این مقدار حافظه PHP را برای وردپرس به 256 مگابایت افزایش می‌دهد. مقدار پیش‌فرض معمولاً 40M یا 64M است.

افزایش حافظه در php.ini

اگر به فایل php.ini دسترسی دارید، مقدار زیر را تغییر دهید:

memory_limit = 256M

در هاست‌های اشتراکی معمولاً می‌توانید از طریق cPanel و بخش MultiPHP INI Editor این مقدار را تغییر دهید.

بررسی مصرف حافظه با کد ساده

برای تست اینکه آیا مشکل از حافظه است، یک فایل PHP ساده با محتوای زیر ایجاد کنید و اجرا کنید:

<?php
echo 'Memory limit: ' . ini_get('memory_limit');
?>

اگر این فایل بدون خطا اجرا شد، مشکل احتمالاً از جای دیگری است.

گام پنجم: عیب‌یابی افزونه‌ها و قالب (در وردپرس)

اگر سایت شما وردپرسی است و مراحل بالا جواب نداد، احتمالاً یک افزونه یا قالب خراب باعث خطای 500 شده است.

غیرفعال کردن همه افزونه‌ها

ساده‌ترین راه این است که از طریق FTP یا فایل‌منیجر، پوشه wp-content/plugins را به طور موقت تغییر نام دهید:

1. به پوشه wp-content بروید.
2. نام پوشه plugins را به plugins_old تغییر دهید.
3. سایت را بررسی کنید. اگر خطا برطرف شد، یک پوشه جدید plugins ایجاد کنید و افزونه‌ها را یکی‌یکی فعال کنید تا مشکل‌دار را پیدا کنید.

تغییر قالب به حالت پیش‌فرض

اگر مشکل از قالب باشد، می‌توانید از طریق FTP به پوشه wp-content/themes بروید و نام پوشه قالب فعلی را تغییر دهید. وردپرس به طور خودکار به قالب پیش‌فرض (مانند Twenty Twenty-Four) برمی‌گردد.

گام ششم: بررسی حافظه و منابع سرور

گاهی خطای 500 به دلیل کمبود منابع سرور (RAM یا CPU) رخ می‌دهد. این مشکل در هاست‌های اشتراکی با منابع محدود شایع‌تر است.

بررسی مصرف منابع در cPanel

در cPanel به بخش Resource Usage بروید و ببینید آیا به محدودیت‌های خود نزدیک شده‌اید. اگر مصرف RAM یا CPU مدام به 100% می‌رسد، باید یا اسکریپت‌های سنگین را بهینه کنید یا پلان هاستینگ خود را ارتقا دهید.

بررسی با دستور top (در SSH)

اگر به سرور دسترسی SSH دارید، دستور top را اجرا کنید و ببینید کدام فرآیندها بیشترین مصرف را دارند:

top -b -n 1 | head -20

اگر یک فرآیند PHP مدام مصرف بالایی دارد، ممکن است یک اسکریپت بدافزار یا یک حلقه بی‌نهایت (infinite loop) در کد شما وجود داشته باشد.

نتیجه‌گیری و جمع‌بندی

رفع خطای 500 معمولاً نیاز به صبر و بررسی سیستماتیک دارد. مسیر پیشنهادی ما به ترتیب اولویت:

1. بررسی لاگ خطا (مهم‌ترین گام)
2. بررسی فایل .htaccess
3. بررسی سطح دسترسی فایل‌ها
4. بررسی محدودیت حافظه PHP
5. عیب‌یابی افزونه‌ها و قالب (در وردپرس)
6. بررسی منابع سرور

اگر پس از انجام همه این مراحل هنوز خطا persist کرد، ممکن است مشکل از تنظیمات سرور یا ماژول‌های Apache/Nginx باشد که نیاز به دخالت تیم پشتیبانی هاستینگ دارد. در این صورت با ارائه لاگ خطا به پشتیبانی، فرآیند رفع مشکل را تسریع کنید.

به یاد داشته باشید که همیشه قبل از هر تغییری از فایل‌های مهم خود (مانند .htaccess و wp-config.php) یک نسخه پشتیبان تهیه کنید. این کار شما را از دردسرهای احتمالی نجات می‌دهد.