رسالة “500 Internal Server Error” المجردة من IIS لا تقول شيئاً تقريباً. التفاصيل في السجلات وفي رقمين إضافيين: الحالة الفرعية وحالة Win32. يبين هذا الدليل أين يكتب IIS سجلاته وكيف تجدون الطلبات الفاشلة وما الأماكن الأخرى التي تُفحص وكيف تفعّلون الأخطاء المفصلة بأمان. المسارات والأوامر من وثائق Microsoft لكنني لم أشغّلها على خادم حقيقي والحقول الدقيقة تعتمد على صيغة السجل لديكم.
١. اعثروا على ملفات السجل
لكل موقع مجلد سجل باسم معرّفه. حدّدوه من PowerShell بدل التخمين:
# Default IIS log folder (per site ID)
C:\inetpub\logs\LogFiles\W3SVC1\
Get-Website | Select Name, Id, @{n='LogDir';e={$_.logFile.directory}}
Get-ChildItem C:\inetpub\logs\LogFiles\W3SVC1 | Sort LastWriteTime -Descending | Select -First 3
أحدث ملف هو عادة الأهم. تستخدم السجلات UTC افتراضياً فحوّلوا الأوقات عند مطابقتها مع بلاغ المستخدم.
٢. ابحثوا عن الطلبات الفاشلة
رشّحوا الحالة 500 ثم اقرؤوا الأعمدة التالية لها. تفصل الحالة الفرعية بين الأسباب، فمثلاً 500.19 يشير إلى الإعداد، وقد تكشف حالة Win32 مشكلة أذونات أو ملفات:
# Find recent 500 responses
Select-String -Path C:\inetpub\logs\LogFiles\W3SVC1\u_ex*.log -Pattern " 500 " | Select -Last 10
# Look at the sub-status and Win32 status columns for the real clue
# The #Fields line at the top of each log shows the column order
يبين سطر #Fields ترتيب الأعمدة وهو قابل للتخصيص، فتحققوا منه قبل الاعتماد على موضع.
٣. افحصوا أحداث ويندوز ومجمعات التطبيقات
كثير من أخطاء 500 هي في الحقيقة انهيارات تطبيق أو إخفاقات مجمع تطبيقات. وغالباً ما يحوي سجلا Application وSystem الاستثناء، ويفسر المجمع المتوقف انقطاعاً مفاجئاً:
Get-WinEvent -LogName Application -MaxEvents 20 | Where-Object { $_.ProviderName -match 'ASP|IIS|\.NET' } | Format-List TimeCreated, Message
& "$env:windir\System32\inetsrv\appcmd.exe" list apppool
& "$env:windir\System32\inetsrv\appcmd.exe" list wp
مجمع يُعاد تدويره أو ينهار أو بيئة تشغيل مفقودة أو هوية خاطئة كلها تظهر هنا.
٤. أظهروا الأخطاء المفصلة بحذر
صفحات الأخطاء المفصلة تفيد أثناء التصحيح لكنها تكشف المسارات والشيفرة للزوار. فضّلوا إظهارها للطلبات المحلية فقط أو فعّلوا Failed Request Tracing لعنوان وحالة محددين:
<!-- web.config -->
<system.web>
<customErrors mode="Off" /> <!-- shows details to every visitor; use only briefly, or limit to local requests -->
</system.web>
أعيدوا الإعداد بعد التحقيق. وتحققوا أيضاً من أذونات الملفات والمجلدات لهوية مجمع التطبيقات. ولا تضعفوا الجدار الناري للاختبار؛ راجعوا دليل الجدار الناري للتغييرات الآمنة.
٥. أسباب شائعة
تشمل الأسباب المعتادة خطأ صياغة في web.config ووحدة أو إصدار بيئة تشغيل مفقوداً وفشل الاتصال بقاعدة البيانات وهوية مجمع بلا أذونات واستثناءً غير معالج في التطبيق. وغالباً تشير الحالة الفرعية وسجل الأحداث معاً إلى أحدها.
٦. مثال توضيحي وليس قياساً حقيقياً
افترضوا موقعاً (مختلقاً) يعيد 500 بعد نشر. يُظهر سجل IIS الحالة 500.19 لكل الطلبات وتشير حالة Win32 إلى خطأ في الإعداد. يذكر سجل الأحداث عنصراً غير صالح في web.config. إزالة العنصر المعطوب وإعادة تدوير المجمع تعيد الموقع وتُظهر أسطر السجل التالية 200.
٧. أخطاء شائعة
- تجاهل رمز الحالة الفرعية.
- قراءة سجلات UTC كأنها توقيت محلي.
- ترك customErrors مطفأً في الإنتاج.
- عدم فحص سجل أحداث ويندوز.
- اتهام التطبيق والمجمع متوقف.
- نسيان أذونات هوية مجمع التطبيقات.
٨. أسئلة شائعة
أين تُخزَّن سجلات IIS؟ افتراضياً تحت C:\inetpub\logs\LogFiles في مجلد لكل معرّف موقع.
ماذا يعني 500.19؟ مشكلة إعداد وغالباً قسم تالف أو مقفل في web.config.
لماذا لا أرى تفاصيل الخطأ؟ تخفيها الأخطاء المخصصة عن المستخدمين البعيدين. استخدموا طلباً محلياً أو Failed Request Tracing.
هل السجلات بالتوقيت المحلي؟ يسجل IIS افتراضياً بتوقيت UTC.
٩. قائمة تحقق سريعة
- حدّدوا مجلد سجل الموقع.
- ابحثوا عن إدخالات 500.
- اقرؤوا الحالة الفرعية وحالة Win32.
- افحصوا سجل Application.
- افحصوا حالة مجمع التطبيقات.
- فعّلوا الأخطاء المفصلة لوقت قصير.
- تحققوا من الأذونات وأعيدوا التدوير.
إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.
تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.
المراجع الرسمية
Microsoft Learn: IIS log file settings · Microsoft Learn: IIS HTTP status codes · Microsoft Learn: Failed Request Tracing · Microsoft Learn: AppCmd
