ماذا يعني
واجه الخادم حالة غير متوقعة ولم يتمكن من إتمام الطلب. إنه رمز عام لأخطاء جهة الخادم.
الأسباب الشائعة
- استثناء غير معالج أو خلل في شيفرة التطبيق
- إعدادات خاطئة، مثل ملف .htaccess معطوب أو متغير بيئة مفقود
- فشل قاعدة بيانات أو اعتمادية لم يُربط بحالة أنسب
طريقة الإصلاح
إن كنت العميل أو الزائر
أعد المحاولة لاحقًا؛ وإن استمر فأبلغ عنه مع الوقت ومعرّف الطلب الوارد في الاستجابة.
إن كنت مسؤولًا عن الموقع أو الواجهة البرمجية
راجع سجلات أخطاء التطبيق والخادم، وأصلح الاستثناء، وأعد رموزًا أدق (502 أو 503 أو 504) عندما يكون السبب معروفًا.
مثال على الاستجابة
HTTP/1.1
HTTP/1.1 500 Internal Server Error
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Internal Server Error",
"status": 500,
"detail": "Something went wrong. Request id: 01J9Z6Q4K2."
} المواصفة
الأسئلة الشائعة
› كيف أجد سبب الخطأ 500؟
راجع سجل أخطاء الخادم أو التطبيق بحثًا عن تتبع المكدس وقت الطلب؛ وفعّل وضع التصحيح في بيئة التطوير فقط.
› هل يمكن أن يسبب ملف .htaccess الخطأ 500؟
نعم. خطأ صياغي أو توجيه غير معروف في .htaccess يجعل Apache يرد بـ 500.