مجله ایرانیکاسرورآموزش سرور، هاست، وردپرس و شبکه
آموزشی

رفع خطای 503 در IIS ویندوز سرور؛ بررسی توقف App Pool و کرش برنامه

فرض کنید وب‌سایت یا نرم‌افزار سازمانی شما روی IIS ویندوز سرور اجرا می‌شود. تا چند دقیقه قبل همه چیز طبیعی بوده، اما حالا کاربران با پیام HTTP Error 503. The service is unavailable مواجه…

رفع خطای 503 در IIS ویندوز سرور؛ بررسی توقف App Pool و کرش برنامه
خلاصه سریع این آموزش

فرض کنید وب‌سایت یا نرم‌افزار سازمانی شما روی IIS ویندوز سرور اجرا می‌شود. تا چند دقیقه قبل همه چیز طبیعی بوده، اما حالا کاربران با پیام HTTP Error 503. The…

۲۰ دقیقه مطالعه ۰ دیدگاه ۲۷ آبان ۱۴۰۵ آخرین به‌روزرسانی

فرض کنید وب‌سایت یا نرم‌افزار سازمانی شما روی IIS ویندوز سرور اجرا می‌شود. تا چند دقیقه قبل همه چیز طبیعی بوده، اما حالا کاربران با پیام HTTP Error 503. The service is unavailable مواجه می‌شوند. سرور روشن است، اتصال شبکه برقرار است و حتی ممکن است سایر وب‌سایت‌های همین سرور بدون مشکل کار کنند.

در چنین وضعیتی، Restart کردن کل Windows Server یا اجرای دستور iisreset بدون بررسی علت می‌تواند ارتباط همه وب‌سایت‌ها را قطع کند؛ درحالی‌که شاید مشکل فقط به یک Application Pool مربوط باشد.

خطای IIS 503 Error معمولاً نشان می‌دهد سرویس موردنظر در زمان درخواست قابل ارائه نیست. علت ممکن است توقف Application Pool، Crash شدن پردازش w3wp.exe، فعال‌شدن Rapid-Fail Protection، مشکل Identity، پرشدن صف درخواست‌ها یا اختلال در زیرساخت پردازش IIS باشد.

در این راهنما یاد می‌گیریم چگونه ابتدا منشأ خطای 503 را پیدا کنیم، وضعیت Application Pool را با IIS Manager و PowerShell بررسی کنیم، لاگ‌های WAS و HTTPERR را بخوانیم و مشکلات حافظه، دسترسی و Crash را بدون Restart کورکورانه عیب‌یابی کنیم.

فهرست مطالب

خطای 503 در IIS چیست؟

کد HTTP 503 به معنی Service Unavailable است؛ یعنی سرور یا لایه پاسخ‌دهنده فعلاً نمی‌تواند درخواست را سرویس‌دهی کند.

در IIS درخواست ابتدا وارد HTTP.sys می‌شود و براساس تنظیمات وب‌سایت و Application Pool به صف و Worker Process مربوط هدایت می‌شود.

اگر Application Pool متوقف شده باشد، Worker Process قابل راه‌اندازی نباشد یا درخواست در شرایط خاص از صف پردازش رد شود، ممکن است پاسخ 503 برگردد.

مسیر ساده‌شده پردازش درخواست در IIS:

Browser / HTTP Client
          |
          v
       HTTP.sys
          |
          v
    IIS Request Queue
          |
          v
   Application Pool
          |
          v
   Worker Process (w3wp.exe)
          |
          v
       Web Application
          |
          v
      HTTP Response

اگر خطا پیش از رسیدن درخواست به Worker Process رخ دهد، ممکن است جزئیات آن در لاگ HTTPERR ثبت شود و در لاگ معمولی وب‌سایت دیده نشود.

منبع رسمی: Microsoft Learn – Troubleshoot HTTP Errors in IIS.

نشانه‌های رایج خطای IIS 503

  • وب‌سایت بلافاصله پس از درخواست، خطای 503 نمایش می‌دهد.
  • Application Pool در IIS Manager روی Stopped قرار دارد.
  • Application Pool پس از Start شدن دوباره متوقف می‌شود.
  • خطا فقط بعد از Deploy یا تغییر تنظیمات برنامه ظاهر شده است.
  • هنگام افزایش تعداد کاربران، خطا به‌صورت مقطعی رخ می‌دهد.
  • پردازش w3wp.exe در Event Viewer دارای خطای Crash است.
  • پس از تغییر رمز حساب اختصاصی Application Pool، وب‌سایت از دسترس خارج شده است.
  • خطا پس از Recycling برنامه یا تحت فشار حافظه دیده می‌شود.

این نشانه‌ها برای شروع عیب‌یابی مفیدند، اما باید با وضعیت واقعی Pool، رویدادهای ویندوز و لاگ درخواست‌ها تطبیق داده شوند.

مهم‌ترین علت‌های خطای 503 در IIS

علت نشانه اولین بررسی
Application Pool متوقف شده 503 مداوم روی یک وب‌سایت Get-WebAppPoolState
Rapid-Fail Protection Pool بعد از چند Crash متوقف می‌شود WAS Event Log
Identity یا رمز اشتباه Worker Process شروع نمی‌شود Identity و Event Viewer
Crash در w3wp.exe Application Error و Windows Error Reporting Application Log
Private Memory Recycling Recycleهای مکرر Recycling Settings
Request Queue Limit خطا هنگام افزایش ترافیک QueueLength و HTTPERR
دسترسی فایل یا پوشه مشکل پس از Deploy یا تغییر مجوزها ACL و هویت Pool
WAS یا W3SVC چندین سایت با هم مشکل دارند Service Status

قبل از عیب‌یابی IIS چه کارهایی انجام دهیم؟

اگر وب‌سایت در حال ارائه سرویس واقعی است، ابتدا اطلاعات ضروری را ثبت کنید:

  • نام دقیق وب‌سایت و Application Pool.
  • زمان شروع خطای 503.
  • اینکه خطا دائمی است یا مقطعی.
  • آخرین Deploy، تغییر Config یا تغییر رمز حساب.
  • وضعیت دسترسی کنسول سرور.
  • آخرین وضعیت سالم برنامه و فایل‌های پیکربندی.
  • امکان دسترسی به بکاپ تنظیمات IIS و داده‌های برنامه.

هشدار: از اجرای فوری iisreset، غیرفعال‌کردن Rapid-Fail Protection، تغییر Identity به LocalSystem یا افزایش نامحدود Memory Limit خودداری کنید. هرکدام ممکن است اختلال را پنهان یا سطح امنیت سرور را کاهش دهند.

مرحله اول: بررسی سرویس‌های WAS و W3SVC

دو سرویس اصلی در این سناریو عبارت‌اند از:

  • WAS: Windows Process Activation Service که در مدیریت فعال‌سازی Worker Processها نقش دارد.
  • W3SVC: World Wide Web Publishing Service که بخشی از سرویس‌دهی وب IIS را مدیریت می‌کند.

PowerShell را با دسترسی Administrator باز کنید:

Get-Service WAS,W3SVC |
    Select-Object Name,Status,StartType

اگر این سرویس‌ها متوقف هستند، قبل از Start یا Restart باید رویدادهای مرتبط و وابستگی‌های سرویس بررسی شوند.

اگر هر دو سرویس Running هستند، هنوز نمی‌توان نتیجه گرفت Application Poolها سالم‌اند؛ زیرا ممکن است تنها Pool مربوط به یک وب‌سایت متوقف شده باشد.

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

در IIS Manager به بخش Sites بروید، وب‌سایت موردنظر را انتخاب کنید و از Basic Settings نام Application Pool را بررسی کنید.

برای مشاهده فهرست وب‌سایت‌ها و Poolها با PowerShell:

Import-Module WebAdministration

Get-Website |
    Select-Object Name,
                  State,
                  PhysicalPath,
                  ApplicationPool

اگر وب‌سایت دارای چند Application یا Virtual Application باشد، هر بخش ممکن است Application Pool جداگانه‌ای داشته باشد. برای بررسی دقیق‌تر Mappingها:

Get-WebApplication |
    Select-Object Site,
                  Path,
                  ApplicationPool,
                  PhysicalPath

این تفاوت مهم است؛ زیرا ممکن است صفحه اصلی وب‌سایت سالم باشد اما یک API یا Application فرعی با 503 مواجه شود.

مرحله سوم: بررسی وضعیت Application Pool

در IIS Manager به بخش Application Pools بروید و وضعیت Pool مرتبط را بررسی کنید.

برای انجام همین کار با PowerShell:

Import-Module WebAdministration

Get-ChildItem IIS:\AppPools |
    Select-Object Name,State

برای یک Pool مشخص:

Get-WebAppPoolState -Name "MyWebsitePool"

نام MyWebsitePool را با نام واقعی جایگزین کنید.

اگر وضعیت Stopped است، قبل از Start مجدد، زمان توقف را با Event Viewer مقایسه کنید. ممکن است Pool عمداً توسط مدیر یا ابزار استقرار متوقف شده باشد؛ یا Rapid-Fail Protection آن را از سرویس خارج کرده باشد.

Start کردن هدفمند Application Pool

پس از ثبت شواهد، اصلاح علت و هماهنگی با مدیر سرویس، می‌توان فقط همان Pool را Start کرد:

Start-WebAppPool -Name "MyWebsitePool"

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

مرحله چهارم: بررسی IIS با AppCmd

ابزار AppCmd برای مشاهده و مدیریت تنظیمات IIS از طریق Command Prompt کاربرد دارد.

فایل اجرایی آن معمولاً در این مسیر قرار دارد:

C:\Windows\System32\inetsrv\appcmd.exe

برای مشاهده Poolها:

%windir%\system32\inetsrv\appcmd.exe list apppool

برای مشاهده Worker Processهای فعال:

%windir%\system32\inetsrv\appcmd.exe list wp

دستورهای دارای متغیر %windir% در این بخش برای Command Prompt نوشته شده‌اند. در PowerShell باید از مسیر اجرایی یا قالب فراخوانی متناسب با آن استفاده کرد.

اگر Pool در وضعیت Started است اما Worker Process در فهرست وجود ندارد، این وضعیت به‌تنهایی اثبات خرابی نیست؛ ممکن است به دلیل On-Demand Activation یا Idle Timeout هنوز پردازشی فعال نشده باشد.

مرحله پنجم: پیدا کردن علت خطای 503 در Event Viewer

Event Viewer یکی از مهم‌ترین ابزارهای تشخیص Crash و توقف Application Pool است.

دو مسیر اصلی برای بررسی عبارت‌اند از:

  • Windows Logs → System برای رویدادهای WAS و سرویس‌ها.
  • Windows Logs → Application برای خطاهای برنامه، .NET Runtime و Windows Error Reporting.

برای مشاهده رویدادهای WAS در ۲۴ ساعت اخیر:

Get-WinEvent -FilterHashtable @{
    LogName = "System"
    StartTime = (Get-Date).AddHours(-24)
} -ErrorAction SilentlyContinue |
    Where-Object {
        $_.ProviderName -match "WAS|W3SVC"
    } |
    Select-Object -First 60 `
        TimeCreated,Id,ProviderName,Message

برای بررسی Crashهای احتمالی برنامه:

Get-WinEvent -FilterHashtable @{
    LogName = "Application"
    StartTime = (Get-Date).AddHours(-24)
} -ErrorAction SilentlyContinue |
    Where-Object {
        $_.ProviderName -match "Application Error|\.NET Runtime|Windows Error Reporting"
    } |
    Select-Object -First 60 `
        TimeCreated,Id,ProviderName,Message

در خروجی، متن رویداد از خود Event ID مهم‌تر است. به نام Application Pool، شناسه Process، فایل DLL خطادار، Exception Code و زمان دقیق Crash دقت کنید.

منبع:
Troubleshoot an IIS Application Pool Crash – Microsoft Learn.

مهم‌ترین رویدادهای WAS در خطای IIS 503

Event ID معنی یا ارتباط رایج
5002 متوقف‌شدن Application Pool پس از شکست‌های تکراری Worker Process
5009 خروج غیرمنتظره Worker Process
5011 از دست رفتن ارتباط WAS با Worker Process
5021 مشکل مرتبط با Identity یا تنظیمات اجرای Worker Process در برخی سناریوها
5057 ناتوانی در ایجاد Worker Process، از جمله برخی مشکلات Identity

شناسه‌ها باید همراه با Event Source، متن کامل رویداد و نسخه IIS تفسیر شوند. یک Event ID به‌تنهایی برای تشخیص قطعی کافی نیست.

مرحله ششم: Rapid-Fail Protection چیست؟

Rapid-Fail Protection یک مکانیزم حفاظتی در IIS است که از اجرای بی‌وقفه Worker Processهایی که مرتب Crash می‌کنند جلوگیری می‌کند.

اگر تعداد شکست‌های Worker Process در یک بازه زمانی مشخص از حد تعیین‌شده عبور کند، IIS می‌تواند Application Pool را متوقف کند و پاسخ 503 به درخواست‌های آن Pool برگرداند.

در تنظیمات رایج IIS، مقدار پیش‌فرض MaxFailures برابر ۵ و بازه آن ۵ دقیقه است؛ اما مقدار واقعی باید از تنظیمات همان سرور بررسی شود.

برای مشاهده تنظیمات Rapid-Fail Protection:

Import-Module WebAdministration

Get-ItemProperty `
    -Path "IIS:\AppPools\MyWebsitePool" `
    -Name failure |
    Format-List *

اگر Application Pool به دلیل Rapid-Fail Protection متوقف شده، باید Event Log را برای پیدا کردن دلیل اصلی Crash بررسی کنید.

برای مثال، یک Exception مدیریت‌نشده در برنامه، خرابی Native Module، نبود Runtime یا مشکل دسترسی ممکن است هر بار هنگام Start شدن Worker Process تکرار شود.

هشدار: غیرفعال‌کردن Rapid-Fail Protection راه‌حل اصولی خطای 503 نیست. این قابلیت مانع چرخه بی‌پایان Crash و Restart می‌شود و خاموش‌کردن آن می‌تواند مصرف منابع و اختلال برنامه را بیشتر کند.

منبع:
Rapid-Fail Protection – Microsoft.

مرحله هفتم: بررسی Crash شدن w3wp.exe

پردازش w3wp.exe یا IIS Worker Process کد برنامه‌های مرتبط با Application Pool را اجرا می‌کند.

اگر برنامه، یک ماژول Native یا کتابخانه جانبی دچار خطای بحرانی شود، Worker Process ممکن است بسته شود.

این وضعیت ممکن است در Application Log با عباراتی مانند Faulting application name: w3wp.exe مشاهده شود.

برای شناسایی پردازش‌های فعال:

Get-Process w3wp -ErrorAction SilentlyContinue |
    Select-Object Id,
                  ProcessName,
                  StartTime,
                  CPU,
                  PrivateMemorySize64

برای ارتباط‌دادن PID به Pool از appcmd list wp استفاده کنید.

اگر Crash بعد از Deploy یک نسخه جدید آغاز شده است، تغییرات کد، Dependencyها، Runtime، فایل web.config و Native DLLها را با آخرین نسخه سالم مقایسه کنید.

برای تحلیل Crashهای پیچیده، ابزارهایی مانند DebugDiag یا Crash Dump مفید هستند؛ اما فایل Dump ممکن است حاوی داده حساس یا اطلاعات درون حافظه برنامه باشد و باید امن نگهداری شود.

منبع:
Troubleshoot a Process Crash in an IIS Application Pool.

مرحله هشتم: بررسی Application Pool Identity

Application Pool برای اجرای Worker Process از یک هویت امنیتی استفاده می‌کند.

در بسیاری از تنظیمات IIS، مقدار پیش‌فرض ApplicationPoolIdentity است؛ اما بعضی برنامه‌ها با حساب Domain یا حساب اختصاصی اجرا می‌شوند.

اگر رمز یک حساب اختصاصی تغییر کرده، حساب غیرفعال شده یا مجوزهای لازم برای آن وجود نداشته باشد، Worker Process ممکن است شروع نشود.

برای مشاهده نوع Identity:

Import-Module WebAdministration

Get-ItemProperty `
    -Path "IIS:\AppPools\MyWebsitePool" `
    -Name processModel |
    Select-Object identityType,userName

اگر Identity از نوع SpecificUser است، وضعیت خود حساب، رمز ذخیره‌شده در تنظیمات IIS و رویدادهای احراز هویت را بررسی کنید.

در صورت استفاده از ApplicationPoolIdentity، هویت معمول برای مجوزدهی به فایل‌های محلی چنین است:

IIS AppPool\MyWebsitePool

نباید برای حل مشکل Identity، بدون بررسی برنامه آن را به LocalSystem یا یک حساب Domain Admin تغییر دهید. این کار سطح دسترسی برنامه را به‌شدت افزایش می‌دهد.

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

اگر خطا بعد از تغییر مسیر سایت یا Deploy رخ داده است، وضعیت NTFS Permission را نیز بررسی کنید.

برای مشاهده ACL یک مسیر نمونه:

Get-Acl "D:\Websites\MyWebsite" |
    Select-Object -ExpandProperty Access

یا در Command Prompt:

icacls "D:\Websites\MyWebsite"

هویت Pool باید متناسب با نیاز برنامه، مجوزهای ضروری برای خواندن فایل‌های وب‌سایت و نوشتن در مسیرهای مشخص‌شده مانند Logs یا Uploads را داشته باشد.

نکته: مشکل مجوز فایل همیشه 503 تولید نمی‌کند؛ در بسیاری از برنامه‌ها خطاهای 500 یا 500.19 هم محتمل هستند. بنابراین ACL را همراه با رویداد واقعی بررسی کنید.

از اختصاص دادن Everyone:FullControl به پوشه وب‌سایت خودداری کنید.

مرحله دهم: بررسی Memory Limit و Recycling

یکی از موضوعاتی که در عیب‌یابی IIS 503 باید بررسی شود، تنظیمات Recycling و مصرف حافظه Worker Process است.

IIS می‌تواند Application Pool را بر اساس زمان، تعداد درخواست‌ها یا محدودیت‌های حافظه Recycle کند.

برای مشاهده تنظیمات:

Import-Module WebAdministration

Get-ItemProperty `
    -Path "IIS:\AppPools\MyWebsitePool" `
    -Name recycling.periodicRestart |
    Format-List *

در این قسمت، مقدار privateMemory به کیلوبایت تعریف می‌شود و مقدار صفر برای برخی محدودیت‌ها به معنی غیرفعال‌بودن آن حد است.

تفاوت مهم: رسیدن به Private Memory Limit معمولاً باعث Recycling برنامه می‌شود، نه اینکه ذاتاً و در تمام شرایط پاسخ 503 ایجاد کند. اگر بعد از Recycle برنامه بالا نیاید یا درخواست‌ها در زمان راه‌اندازی با مشکل مواجه شوند، ممکن است 503 نیز دیده شود.

بنابراین صرف مشاهده Recycling نباید به معنی تشخیص علت اصلی 503 باشد.

منبع:
IIS Application Pool Recycling Settings.

مرحله یازدهم: اندازه‌گیری مصرف حافظه و فشار منابع

برای بررسی مصرف حافظه کل سیستم:

Get-Counter -Counter @(
    "\Memory\Available MBytes",
    "\Memory\% Committed Bytes In Use"
) -SampleInterval 2 -MaxSamples 5

برای بررسی مصرف حافظه Worker Processها:

Get-Process w3wp -ErrorAction SilentlyContinue |
    Select-Object Id,
                  PrivateMemorySize64,
                  WorkingSet64,
                  CPU

مقدار PrivateMemorySize64 بر حسب بایت است. اگر مصرف حافظه در طول زمان مرتب افزایش پیدا می‌کند، باید احتمال Memory Leak در برنامه یا Native Module بررسی شود.

فقط یک نمونه از میزان RAM برای تشخیص Memory Leak کافی نیست. بهتر است داده‌های PerfMon در یک بازه طولانی، همراه با PID و زمان Recycling ثبت شوند.

اگر چند سایت روی یک Pool مشترک اجرا می‌شوند، جداکردن Poolها می‌تواند به عیب‌یابی و ایزوله‌سازی کمک کند؛ البته نیازمند ارزیابی مصرف منابع و تنظیمات برنامه است.

مرحله دوازدهم: بررسی HTTPERR؛ وقتی درخواست به IIS Log نمی‌رسد

یکی از اشتباه‌های رایج این است که مدیر فقط پوشه لاگ وب‌سایت IIS را بررسی می‌کند.

برخی خطاهای 503 در لایه HTTP.sys رخ می‌دهند و ممکن است در HTTPERR ثبت شوند.

مسیر پیش‌فرض این لاگ‌ها معمولاً چنین است:

C:\Windows\System32\LogFiles\HTTPERR

برای مشاهده جدیدترین فایل:

$path = "$env:windir\System32\LogFiles\HTTPERR"

Get-ChildItem $path -Filter "*.log" |
    Sort-Object LastWriteTime -Descending |
    Select-Object -First 5 Name,LastWriteTime,Length

برای خواندن آخرین خطوط جدیدترین لاگ:

$latest = Get-ChildItem $path -Filter "*.log" |
    Sort-Object LastWriteTime -Descending |
    Select-Object -First 1

if ($latest) {
    Get-Content $latest.FullName -Tail 100
}

در فایل HTTPERR، ستون s-reason می‌تواند سرنخی درباره علت رد درخواست ارائه کند.

نمونه علت‌ها شامل AppOffline، AppPoolTimer و QueueFull هستند. باید آن‌ها را با وضعیت Pool و Event Log همان لحظه تطبیق داد.

منبع:
HTTP Server API Error Log Reasons.

مرحله سیزدهم: بررسی لاگ درخواست‌های IIS

مسیر رایج لاگ وب‌سایت‌های IIS:

C:\inetpub\logs\LogFiles\W3SVC*

هر وب‌سایت می‌تواند شناسه Site و مسیر Logging متفاوتی داشته باشد.

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

  • sc-status: کد HTTP.
  • sc-substatus: زیرکد IIS.
  • sc-win32-status: کد خطای مرتبط با ویندوز.
  • time-taken: زمان پردازش درخواست.
  • cs-uri-stem: مسیر درخواست.

اگر خطای 503 در لاگ IIS وجود ندارد، بررسی HTTPERR و لایه‌های جلویی مانند Reverse Proxy یا Load Balancer اهمیت بیشتری پیدا می‌کند.

برعکس، اگر فقط برخی URLها 503 می‌دهند، باید Application Mapping و رفتار همان برنامه بررسی شود.

مرحله چهاردهم: بررسی Queue Length و درخواست‌های هم‌زمان

در زمان ترافیک بالا، ممکن است Worker Process نتواند درخواست‌ها را به سرعت کافی پردازش کند.

اگر صف درخواست Application Pool به سقف مجاز برسد، درخواست‌های جدید ممکن است با 503 رد شوند.

برای مشاهده Queue Length:

Import-Module WebAdministration

Get-ItemProperty `
    -Path "IIS:\AppPools\MyWebsitePool" `
    -Name queueLength

پیش از افزایش Queue Length، باید CPU، حافظه، زمان پاسخ برنامه، اتصال دیتابیس و تعداد درخواست‌های فعال بررسی شوند.

افزایش صف بدون رفع کندی برنامه ممکن است فقط زمان انتظار کاربران را بیشتر کند.

برای بارهای سنگین، داده‌های Performance Monitor درباره Request Queue و زمان پاسخ IIS می‌توانند مکمل لاگ‌ها باشند.

مرحله پانزدهم: خطای 503 در برنامه‌های ASP.NET Core

اگر وب‌سایت شما ASP.NET Core است، علاوه بر Application Pool باید وضعیت ASP.NET Core Module و Runtime موردنیاز را بررسی کنید.

برای مثال، نبود نسخه مناسب .NET Runtime، خطای Start برنامه یا تنظیمات نادرست web.config ممکن است باعث شکست راه‌اندازی برنامه شود.

بااین‌حال، تمام خطاهای Startup در ASP.NET Core به 503 تبدیل نمی‌شوند. برخی خطاها با کدهایی مانند 500.30 یا 502.5 نمایش داده می‌شوند.

برای مشاهده Runtimeهای نصب‌شده:

dotnet --list-runtimes

اگر دستور dotnet در PATH موجود نیست، باید محل نصب Runtime و وضعیت Hosting Bundle بررسی شود.

برای تشخیص خطاهای Startup، Event Viewer، لاگ خود برنامه و ابزارهای ASP.NET Core Module از منابع اصلی هستند.

منبع:
ASP.NET Core IIS Troubleshooting Reference.

مرحله شانزدهم: استفاده از Failed Request Tracing

اگر خطا مقطعی است و شواهد لاگ‌های معمولی کافی نیستند، Failed Request Tracing یا FREB می‌تواند اطلاعات دقیق‌تری از مسیر پردازش درخواست ارائه کند.

برای استفاده از آن، قابلیت Tracing در IIS باید نصب و برای وب‌سایت فعال شده باشد.

با تعریف Rule مناسب برای وضعیت HTTP موردنظر می‌توان اطلاعات Diagnostic ثبت کرد.

مسیر معمول فایل‌های خروجی:

C:\inetpub\logs\FailedReqLogFiles

نکته: اگر خطای 503 در HTTP.sys و پیش از ورود درخواست به Pipeline وب‌سایت رخ دهد، FREB ممکن است اطلاعاتی درباره آن درخواست ثبت نکند. در این صورت HTTPERR و WAS Event Log اهمیت بیشتری دارند.

Tracing را فقط برای مدت لازم فعال کنید تا حجم لاگ و سربار آن بی‌دلیل افزایش پیدا نکند.

منبع:
Troubleshoot Failed Requests Using IIS Tracing.

آیا برای رفع خطای 503 باید iisreset اجرا کنیم؟

دستور iisreset می‌تواند چند سرویس و وب‌سایت مرتبط با IIS را تحت تأثیر قرار دهد.

اگر فقط یک Application Pool مشکل دارد، Restart سراسری IIS معمولاً اقدام متناسبی نیست.

در مواردی که علت اصلاح شده و صرفاً راه‌اندازی مجدد Pool لازم است، می‌توان از دستور زیر استفاده کرد:

Restart-WebAppPool -Name "MyWebsitePool"

این فرمان نیز تغییر‌دهنده است و درخواست‌های در حال اجرا یا وضعیت برنامه را تحت تأثیر قرار می‌دهد. بنابراین باید در شرایط مناسب اجرا شود.

اگر Pool متوقف شده باشد، دستور Restart ممکن است مناسب نباشد و ابتدا باید علت توقف و روش صحیح Start بررسی شود.

اسکریپت یکپارچه عیب‌یابی IIS 503 بدون تغییر تنظیمات

اسکریپت زیر برای جمع‌آوری اولیه شواهد طراحی شده است. وضعیت سرویس‌ها، وب‌سایت‌ها، Application Poolها، Worker Processها، حافظه و رویدادهای WAS را نمایش می‌دهد.

این نسخه هیچ Application Pool یا سرویس IIS را Start، Stop یا Restart نمی‌کند.

Import-Module WebAdministration -ErrorAction Stop

Write-Host "===== IIS SERVICES ====="

Get-Service WAS,W3SVC |
    Select-Object Name,Status,StartType

Write-Host "===== WEBSITES ====="

Get-Website |
    Select-Object Name,State,
                  ApplicationPool,PhysicalPath

Write-Host "===== APPLICATION POOLS ====="

Get-ChildItem IIS:\AppPools |
    Select-Object Name,State

Write-Host "===== WORKER PROCESSES ====="

Get-Process w3wp -ErrorAction SilentlyContinue |
    Select-Object Id,ProcessName,
                  PrivateMemorySize64,WorkingSet64

Write-Host "===== PROCESS MAPPING ====="

$appcmd = "$env:windir\System32\inetsrv\appcmd.exe"

if (Test-Path $appcmd) {
    & $appcmd list wp
}

Write-Host "===== SYSTEM MEMORY ====="

Get-CimInstance Win32_OperatingSystem |
    Select-Object TotalVisibleMemorySize,
                  FreePhysicalMemory

Write-Host "===== WAS EVENTS ====="

Get-WinEvent -FilterHashtable @{
    LogName = "System"
    StartTime = (Get-Date).AddDays(-2)
} -ErrorAction SilentlyContinue |
    Where-Object {
        $_.ProviderName -match "WAS|W3SVC"
    } |
    Select-Object -First 40 `
        TimeCreated,Id,ProviderName,Message

Write-Host "===== APPLICATION CRASH EVENTS ====="

Get-WinEvent -FilterHashtable @{
    LogName = "Application"
    StartTime = (Get-Date).AddDays(-2)
} -ErrorAction SilentlyContinue |
    Where-Object {
        $_.ProviderName -match "Application Error|\.NET Runtime"
    } |
    Select-Object -First 40 `
        TimeCreated,Id,ProviderName,Message

Write-Host "===== HTTPERR LOGS ====="

$httpErr = "$env:windir\System32\LogFiles\HTTPERR"

if (Test-Path $httpErr) {
    Get-ChildItem $httpErr -Filter "*.log" |
        Sort-Object LastWriteTime -Descending |
        Select-Object -First 5 `
            Name,LastWriteTime,Length
}

برای بررسی نهایی، نتیجه این اسکریپت را با یک درخواست واقعی، زمان خطا و لاگ‌های همان وب‌سایت مقایسه کنید.

در سرورهایی با تعداد زیاد وب‌سایت، ممکن است بررسی رویدادهای تمام Poolها زمان بیشتری بگیرد.

ماتریس تصمیم‌گیری برای رفع IIS 503

نتیجه تشخیص اقدام پیشنهادی
Pool متوقف و WAS 5002 ثبت شده بررسی Rapid-Fail و علت Crash پیش از Start
خطای Identity در WAS بررسی حساب، رمز و مجوزهای لازم
w3wp.exe مرتب Crash می‌کند بررسی Runtime، DLL و Crash Dump
Recycleهای مکرر با افزایش حافظه بررسی Memory Leak و تنظیمات Recycling
HTTPERR شامل QueueFull است بررسی فشار درخواست، سرعت برنامه و Queue Length
سایت بعد از Deploy از دسترس خارج شده مقایسه Config و نسخه برنامه با آخرین نسخه سالم
فقط یک Application مشکل دارد بررسی Mapping برنامه و Pool همان Application
چند سایت روی سرور هم‌زمان خطا دارند بررسی سرویس‌های مشترک، منابع و لایه HTTP.sys

اشتباه‌های رایج هنگام رفع خطای 503 در IIS

۱. اجرای iisreset برای مشکل یک Application Pool

این کار ممکن است وب‌سایت‌های سالم را نیز دچار اختلال کند.

۲. Start کردن مکرر Pool بدون بررسی Crash

اگر علت اصلی باقی بماند، Worker Process دوباره شکست می‌خورد.

۳. غیرفعال‌کردن Rapid-Fail Protection

این کار مکانیزم حفاظتی IIS را تضعیف می‌کند و خطای برنامه را برطرف نمی‌کند.

۴. تغییر Identity به Administrator یا LocalSystem

این اقدام می‌تواند سطح دسترسی برنامه را به شکل خطرناکی افزایش دهد.

۵. افزایش نامحدود Memory Limit

اگر برنامه Memory Leak دارد، افزایش حد حافظه فقط زمان بروز دوباره مشکل را تغییر می‌دهد.

۶. بررسی فقط IIS Access Log

در برخی پاسخ‌های 503، اطلاعات اصلی در HTTPERR یا WAS Event Log ثبت شده است.

۷. فرض اینکه تمام خطاهای ASP.NET Core از IIS هستند

ممکن است مشکل از Runtime، Hosting Bundle یا Startup برنامه باشد.

۸. بی‌توجهی به Queue Length

ممکن است Pool روشن باشد، اما سرعت پردازش برای حجم درخواست کافی نباشد.

۹. نتیجه‌گیری از یک عدد مصرف RAM

برای تشخیص Memory Leak باید روند مصرف حافظه در طول زمان بررسی شود.

۱۰. نادیده‌گرفتن تغییرات اخیر

Deploy برنامه، تغییر رمز Identity یا اصلاح فایل web.config می‌توانند علت شروع ناگهانی مشکل باشند.

چک‌لیست کامل عیب‌یابی IIS 503 Error

  • ثبت URL، زمان و الگوی رخداد خطا.
  • شناسایی وب‌سایت و Application Pool مربوط.
  • بررسی WAS و W3SVC.
  • بررسی وضعیت Application Pool.
  • مشاهده Worker Process و PID واقعی.
  • بررسی System Log برای خطاهای WAS.
  • بررسی Application Log برای Crash.
  • کنترل Rapid-Fail Protection.
  • بررسی Identity، رمز و Permissionها.
  • کنترل فایل web.config و تغییرات Deploy.
  • بررسی Private Memory و Recycling.
  • اندازه‌گیری RAM و CPU در زمان خطا.
  • بررسی Queue Length در بار بالا.
  • خواندن HTTPERR و IIS Access Log.
  • بررسی Runtime و Hosting Bundle برنامه.
  • استفاده از FREB یا Crash Dump در صورت نیاز.
  • اصلاح علت پیش از Start یا Restart هدفمند Pool.
  • تست درخواست و مانیتورینگ پس از اصلاح.

جمع‌بندی؛ خطای 503 در IIS را از کجا شروع کنیم؟

اگر IIS پیام 503 Service Unavailable نمایش می‌دهد، ابتدا وضعیت Application Pool مربوط به وب‌سایت را بررسی کنید.

اگر Pool متوقف شده است، Event Viewer و رویدادهای WAS می‌توانند نشان دهند مشکل از Rapid-Fail Protection، Crash یا Identity است. اگر Pool فعال است، باید HTTPERR، Queue Length، زمان پاسخ برنامه و منابع سیستم بررسی شوند.

در خطاهای مرتبط با حافظه، توجه به Private Memory، Recycling و روند مصرف RAM اهمیت دارد. در مشکل Identity نیز باید رمز، مجوزهای فایل و حساب اجرایی بررسی شوند؛ بدون اینکه سطح دسترسی برنامه بی‌دلیل افزایش پیدا کند.

اصل مهم: خطای 503 را با شناسایی منشأ توقف درخواست برطرف کنید، نه صرفاً با Restart کل IIS. ثبت شواهد و اصلاح هدفمند معمولاً اختلال کمتری ایجاد می‌کند و از تکرار مشکل جلوگیری می‌کند.

سؤالات متداول درباره خطای IIS 503

خطای 503 در IIS یعنی چه؟

یعنی سرور یا لایه پردازش درخواست در آن لحظه قادر به ارائه سرویس موردنظر نیست. توقف Application Pool و مشکلات Worker Process از علت‌های رایج‌اند.

چرا Application Pool در IIS خودکار متوقف می‌شود؟

یکی از دلایل، فعال‌شدن Rapid-Fail Protection پس از Crashهای مکرر Worker Process است.

چگونه وضعیت Application Pool را با PowerShell بررسی کنیم؟

با استفاده از Get-WebAppPoolState یا ابزار AppCmd می‌توان وضعیت Pool را مشاهده کرد.

Rapid-Fail Protection چیست؟

قابلیت حفاظتی IIS است که در صورت تکرار شکست Worker Process در یک بازه زمانی، Application Pool را از سرویس خارج می‌کند.

آیا کمبود RAM باعث خطای 503 می‌شود؟

می‌تواند از طریق اختلال در اجرای Worker Process یا فشار منابع نقش داشته باشد، اما هر خطای 503 ناشی از کمبود حافظه نیست.

آیا محدودیت Private Memory مستقیماً خطای 503 ایجاد می‌کند؟

معمولاً رسیدن به این حد باعث Recycling می‌شود. اگر راه‌اندازی مجدد برنامه شکست بخورد، ممکن است خطای 503 نیز رخ دهد.

خطای IIS 503 بعد از تغییر رمز حساب از چیست؟

اگر Application Pool با حساب اختصاصی اجرا شود، ناهماهنگی رمز یا مشکل مجوز می‌تواند مانع شروع Worker Process شود.

لاگ اصلی خطای 503 کجاست؟

باید System و Application Event Log، فایل‌های HTTPERR و در صورت ثبت درخواست، IIS Access Log بررسی شوند.

آیا iisreset برای رفع خطای 503 مناسب است؟

به‌عنوان اولین اقدام توصیه نمی‌شود؛ زیرا ممکن است همه سایت‌های IIS را تحت تأثیر قرار دهد.

چرا خطای 503 فقط هنگام افزایش کاربران ظاهر می‌شود؟

ممکن است صف درخواست‌ها پر شود یا برنامه به دلیل محدودیت CPU، حافظه، دیتابیس یا زمان پردازش پاسخ‌گو نباشد.

زیرساخت پایدار برای وب‌سایت‌های ویندوزی

برای میزبانی IIS و برنامه‌های سازمانی، سروری متناسب با نیازتان انتخاب کنید

اجرای وب‌سایت‌های مبتنی بر IIS، APIهای ویندوزی و نرم‌افزارهای سازمانی به منابع پردازشی مناسب، حافظه کافی و زیرساخت پایدار نیاز دارد. سرویس‌های سرور مجازی ایرانیکاسرور را بررسی کنید و برای انتخاب منابع متناسب با پروژه خود مشاوره بگیرید.

اشتراک‌گذاری مقاله
گفت‌وگو درباره آموزش

دیدگاه‌ها (۰)

هنوز دیدگاهی ثبت نشده است.

دیدگاه یا سؤال خود را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *