خطای 502.5 در لود دات نت کور

مقدمه خطای 502.5 یکی از خطاهای رایج در هنگام اجرای برنامه های ASP .NET Core بر روی سرورهای IIS و Plesk است. این خطا معمولاً به دلیل مشکلات مرتبط با DNS، پیکربندی نادرست سرور، تنظیمات نادرست در فایل های پیکربندی و یا مشکلات دسترسی به لاگ ها رخ می دهد. در این مقاله، به بررسی مراحل حل این خطا می پردازیم.

۱. بررسی DNS دامنه

یکی از اولین اقداماتی که باید انجام دهید، بررسی وضعیت DNS دامنه است. برای این کار:

🔹 اطمینان حاصل کنید که DNS های دامنه به درستی تنظیم شده باشند.

🔹 می توانید از ابزار nslookup در ویندوز یا dig در لینوکس برای بررسی وضعیت DNS استفاده کنید:

nslookup yourdomain.com
dig yourdomain.com

🔹 در صورتی که DNS به درستی تنظیم نشده باشد، ممکن است نیاز به اعمال تغییرات در تنظیمات DNS داشته باشید.

۲. ورود به Plesk

برای بررسی دقیق تر و رفع مشکل، نیاز است که به کنترل پنل Plesk وارد شوید:

🔹 از طریق مرورگر، به آدرس Plesk خود بروید.

🔹 نام کاربری و رمز عبور خود را وارد کنید.

🔹 به بخش مربوط به دامنه موردنظر بروید و تنظیمات سرور را بررسی کنید.

۳. ایجاد یک فولدر با نام logs و اختصاص پرمیشن Full Control به این فولدر

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

🔹 به دایرکتوری wwwroot پروژه خود در Plesk مراجعه کنید.

🔹 فولدری با نام logs ایجاد کنید.

🔹 دسترسی Full Control را برای این فولدر فعال کنید تا برنامه بتواند لاگ ها را در آن ذخیره کند.

۴. قرار دادن stdlogenabled روی true در web .config

برای فعال کردن ثبت خطاهای مربوط به ASP .NET Core در IIS، باید مقدار stdlogenabled را در فایل web .config تغییر دهید:

🔹 فایل web .config را باز کنید.

🔹 مقدار زیر را بررسی کرده و در صورت نبود، اضافه کنید:

<aspNetCore processPath="dotnet" arguments="yourapp.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout">
</aspNetCore>

🔹 پس از انجام این تغییرات، IIS را ریستارت کنید و مجدداً وضعیت سایت را بررسی نمایید.

۵. حذف دو کاراکتر V2 از مقدار AspNetCoreModule و سپس بررسی وضعیت سایت

در برخی موارد، مقدار AspNetCoreModuleV2 ممکن است باعث ایجاد خطای 502.5 شود. برای رفع این مشکل:

🔹 فایل web .config را باز کنید.

🔹 مقدار AspNetCoreModuleV2 را به AspNetCoreModule تغییر دهید:

<aspNetCore processPath="dotnet" arguments="yourapp.dll" hostingModel="InProcess" />

🔹 تغییرات را ذخیره کرده و مجدداً سایت را تست کنید.

۶. بررسی لاگ‌های ایجاد شده در فولدر logs

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

🔹 به فولدر logs مراجعه کنید.

🔹 فایل های جدید ثبت شده را بررسی کنید.

🔹 اگر در لاگ ها خطای خاصی مشاهده شد، بر اساس آن اقدام به رفع مشکل کنید.

۷. بررسی Connection String در فایل appsettings .json

در برخی موارد، مقدار نادرست Connection String می تواند باعث خطای 502.5 شود. برای بررسی این مورد:

🔹 فایل appsettings .json را باز کنید.

🔹 مقدار ConnectionStrings را بررسی کنید:

“ConnectionStrings”: {
“DefaultConnection”: “Server=myserver;Database=mydb;User Id=myuser;Password=mypassword;”
}

🔹 اطمینان حاصل کنید که اطلاعات سرور، نام دیتابیس، نام کاربری و رمز عبور صحیح باشند.

۸. حل مشکل طبق لاگ ایجاد شده و یا اعلام مسیر لاگ‌ها به مشتری جهت بررسی و رفع مشکل توسط برنامه نویس

اگر با بررسی لاگ ها، مشکل قابل حل باشد:

✅ بر اساس خطای ثبت شده، اقدام به رفع آن کنید.

✅ در صورتی که نیاز به تغییرات در کدهای برنامه باشد، مسیر لاگ ها را به مشتری اعلام کنید تا برنامه نویس بتواند مشکل را بررسی و برطرف نماید.

نتیجه گیری

خطای 502.5 در ASP.NET Core معمولاً به دلیل مشکلات پیکربندی، عدم دسترسی به لاگ ها، تنظیمات نادرست web config و یا مشکلات DNS رخ می دهد. با انجام مراحل ذکر شده در این مقاله، می توانید به صورت مرحله به مرحله علت مشکل را پیدا کرده و آن را برطرف کنید.

✅ این مقاله برای بخش دانشنامه مارال هاست تنظیم شده است وجهت کمک به کاربران برای حل مشکل خطای 502.5 . 🚀