عیب‌یابی خطای HTTP Error 500 در IIS

خطای HTTP Error 500 – Internal Server Error نشان می‌دهد درخواست به Web Server رسیده، اما IIS یا Application هنگام پردازش آن با خطای سمت سرور مواجه شده است.

برخلاف خطاهایی مانند 404 که معمولاً به پیدا نشدن Resource مربوط هستند، خطای 500 می‌تواند دلایل مختلفی داشته باشد؛ از مشکل در web.config و Application Pool گرفته تا Permission، Moduleهای IIS یا خطای خود Application.

IIS برای بسیاری از خطاهای 500 یک Substatus Code نیز ثبت می‌کند که در پیدا کردن علت اصلی بسیار مهم است.

HTTP Error 500 در IIS چیست؟

کدهای 5xx نشان می‌دهند Server هنگام پردازش Request نتوانسته پاسخ صحیح ایجاد کند. برای مثال ممکن است Browser فقط پیام زیر را نمایش دهد:

HTTP Error 500.0 - Internal Server Error
یا
HTTP Error 500.19 - Internal Server Error

این دو خطا الزاماً علت یکسانی ندارند. برای مثال 500.19 معمولاً به Configuration مربوط است، در حالی که 500.0 می‌تواند از Application، Module، ISAPI یا دلایل دیگر سمت Server ایجاد شود.

خطاهای رایج 500 در IIS

برخی Substatusهای مهم عبارت‌اند از:

Microsoft این Substatusها را برای مشخص کردن دقیق‌تر علت خطای 500 در IIS ثبت می‌کند.

مرحله اول: متن کامل خطا را بررسی کنید

اولین کار این است که فقط عبارت:

500 Internal Server Error

را نبینید. به عدد کامل خطا توجه کنید. مثلاً

HTTP Error 500.19

و در صورت نمایش، مقدار:

Error Code
HRESULT
Config Error
Config File

را توجه کنید. برای مثال در خطای 500.19 ممکن است چیزی مانند زیر مشاهده شود:

Error Code: 0x8007000d

همین Error Code می‌تواند مشخص کند مشکل از XML نامعتبر، Module نصب‌نشده، Permission یا Configuration دیگری است.

مرحله دوم: بررسی وضعیت Website

IIS Manager را باز کنید:

Server Manager
> Tools
> Internet Information Services (IIS) Manager

سپس:

Sites
> ExampleSite

را بررسی کنید. Website باید در وضعیت Started باشد. اگر Stopped است:

Manage Website
> Start

را انتخاب کنید. اگر Website Start نمی‌شود، Application Pool و Event Viewer را در مراحل بعد بررسی کنید.

مرحله سوم: Application Pool را بررسی کنید

وارد

IIS Manager
> Application Pools

شوید. Application Pool مربوط به Website را پیدا کنید. وضعیت آن باید:

Started

باشد.

مرحله چهارم: بررسی web.config

یکی از مهم‌ترین دلایل خطای 500 در IIS فایل:

web.config

است. این فایل داخل Physical Path سایت قرار دارد. برای مشاهده Physical Path:

Sites
> ExampleSite
> Basic Settings...

برای مثال:

C:\inetpub\sites\example

سپس فایل زیر را بررسی کنید:

C:\inetpub\sites\example\web.config

مرحله پنجم: Permission پوشه سایت را بررسی کنید

Application Pool باید بتواند فایل‌های موردنیاز Website را بخواند. فرض کنید Pool سایت:

ExamplePool

و Physical Path:

C:\inetpub\sites\example

است. در Properties پوشه وارد:

Security

شوید. برای Website ساده معمولاً دسترسی Read و Read & Execute کافی است. اگر Application باید فایل Upload کند یا Cache بنویسد، Permission نوشتن فقط روی Directory موردنیاز داده شود.

مرحله ششم: IIS Logs را بررسی کنید

IIS به‌صورت پیش‌فرض Logهای Websiteها را معمولاً زیر مسیر زیر نگهداری می‌کند:

C:\inetpub\logs\LogFiles

هر Website Directory جداگانه‌ای مانند:

W3SVC1
W3SVC2

خواهد داشت. فایل Log مربوط به زمان ایجاد خطا را باز کنید.

مرحله هفتم: Event Viewer را بررسی کنید

اگر IIS Log علت کافی ارائه نمی‌دهد، Event Viewer را باز کنید:

Server Manager
> Tools
> Event Viewer

سپس ابتدا مسیر:

Windows Logs
> Application

را بررسی کنید. زمان Event باید با زمان دریافت HTTP 500 مقایسه شود. به Eventهایی با Level زیر توجه کنید:

Error
Critical
Warning

به‌خصوص مواردی که نام Process زیر را دارند:

w3wp.exe

اگر Worker Process Crash کرده باشد، Event Viewer ممکن است Faulting Module یا Exception مربوطه را نشان دهد.

مرحله هشتم: Detailed Errors را به‌صورت Local فعال کنید

ممکن است Browser فقط پیام عمومی:

500 - Internal server error

را نمایش دهد. برای عیب‌یابی از داخل خود Server:

IIS Manager
> Sites
> ExampleSite
> Error Pages

را باز کنید و سپس Edit Feature Settings... را انتخاب کنید. برای عیب‌یابی می‌توان Detailed Errors را مشاهده کرد.

مرحله نهم: Moduleهای موردنیاز Application را بررسی کنید

خطای:

500.21

معمولاً به Moduleای مربوط است که IIS آن را نمی‌شناسد.این حالت ممکن است زمانی رخ دهد که Application برای یک Component یا Module پیکربندی شده باشد اما آن Component روی Server نصب نشده باشد. برای مثال:

• URL Rewrite
• ASP.NET
• CGI
• FastCGI
• ASP.NET Core Module

بنابراین Technology مورد استفاده Website را مشخص کنید و Featureهای موردنیاز آن را بررسی کنید.

ترتیب پیشنهادی عیب‌یابی HTTP 500

برای اینکه بدون دلیل تنظیمات مختلف IIS را تغییر ندهید، این ترتیب مناسب است:

1. ثبت Error Code و Substatus
        ↓
2. بررسی Website و Application Pool
        ↓
3. بررسی web.config
        ↓
4. بررسی Permission و Physical Path
        ↓
5. بررسی IIS Logs
        ↓
6. بررسی Event Viewer
        ↓
7. مشاهده Detailed Error به‌صورت Local
        ↓
8. بررسی Runtime / Module / Application

این ترتیب کمک می‌کند ابتدا اطلاعات واقعی خطا جمع‌آوری شود و سپس تغییر لازم انجام شود.

جمع‌بندی

HTTP Error 500 در IIS یک خطای کلی سمت Server است و بدون بررسی Substatus نباید درباره علت آن نتیجه‌گیری کرد. اولین قدم این است که مشخص شود خطا مثلاً:

500.0
یا
500.19

است. سپس به‌ترتیب Application Pool، web.config، Permission، IIS Logs، Event Viewer بررسی شوند.
برای خطاهای Configuration مانند 500.19، فایل web.config و Moduleهای نصب‌شده اهمیت زیادی دارند؛ در حالی که خطاهای عمومی 500.0 ممکن است مستقیماً از Application یا Componentهای IIS ایجاد شوند.