إصلاح الخطأ 500.19: صفحة التكوين غير صالحة أثناء نشر مشروع Blazor على IIS

فهم خطأ التكوين في نشر IIS

يمكن أن يكون نشر مشروع Blazor إلى IIS عملية سلسة، ولكن في بعض الأحيان تظهر أخطاء يصعب تشخيصها. إحدى المشكلات الشائعة التي يواجهها المطورون هي خطأ 500.19، والذي يشير عادةً إلى وجود مشكلة في صفحة التكوين. يمنع هذا الخطأ تشغيل التطبيق بشكل صحيح.

يشير الخطأ 500.19 عادةً إلى وجود خطأ في التكوين في ملف web.config الملف، ولكن حتى بعد مراجعته، قد يستمر الخطأ. يمكن أن يكون هذا الموقف محبطًا عندما لا يظهر أي خطأ في التكوين نفسه. غالبًا ما يواجه المطورون هذا الأمر عند محاولة نشر تطبيقات Blazor، خاصة عندما تبدو رسالة الخطأ غامضة.

بخلاف مشكلات التكوين، قد تكون هناك مشكلات أساسية في الأذونات أو مكونات مفقودة على الخادم. على سبيل المثال، يمكن أيضًا أن تؤدي المشكلات المتعلقة بأذونات IIS أو البيئة التي تم تكوينها بشكل غير صحيح إلى حدوث هذا الخطأ. يعد التأكد من وجود جميع الوحدات والأذونات الضرورية أمرًا بالغ الأهمية لنجاح النشر.

في هذه المقالة، سنستكشف الخطوات التي يمكنك اتخاذها لاستكشاف الأخطاء وإصلاحها خطأ 500.19 وحل مشكلات التكوين. من خلال فحص ملف web.config، والتحقق من الأذونات، والتحقق من بيئة الخادم، يمكنك تحديد السبب الجذري للمشكلة.

فهم البرامج النصية لخطأ نشر Blazor

تم تصميم البرنامج النصي الأول المقدم للتعامل مع التكوينات الخاطئة المحتملة داخل ملف web.config الملف، والذي غالبًا ما يسبب الخطأ 500.19 في IIS. العنصر الحاسم هنا هو `"المعالج، الذي يدمج تطبيق Blazor مع بيئة IIS. تقوم هذه العلامة بتوجيه IIS إلى مسار التطبيق الصحيح وتضمن تشغيل التطبيق باستخدام AspNetCoreModuleV2 للاستضافة قيد التشغيل. إذا لم يتم تعيين هذه الوحدة أو تكوينها بشكل صحيح، فلن يبدأ تطبيق Blazor، مما يؤدي إلى الخطأ 500.19. يجب أيضًا أن يكون مسار العملية ومعلمات التسجيل دقيقين، حيث يساعدان في تحديد موقع الملف القابل للتنفيذ وإدارة مخرجات السجل.

في الحل الثاني، نعالج مشكلات الأذونات المحتملة باستخدام PowerShell. ال com.icacls يمنح الأمر الأذونات اللازمة لمجموعة IIS_IUSRS، وهو أمر حيوي لتطبيق Blazor للوصول إلى أدلةه وملفاته. بدون هذه الأذونات، قد يقوم الخادم بحظر تشغيل التطبيق، مما يؤدي إلى حدوث أخطاء مثل 500.19. باستخدام PowerShell، يمكنك تعيين هذه الأذونات بسرعة في برنامج نصي دفعي، مما يضمن حصول جميع المستخدمين والمجموعات الضرورية على حق الوصول للقراءة والكتابة إلى مجلد التطبيق.

يركز الحل الثالث على تصحيح الأخطاء من خلال تمكين تسجيل الخروج القياسي ضمن تكوين Blazor. تمكين stdoutLogEnabled يساعد على التقاط أخطاء وقت التشغيل عن طريق تسجيلها في ملف محدد. تعتبر هذه الطريقة بالغة الأهمية أثناء النشر، حيث يمكن اكتشاف العديد من الأخطاء غير المرئية من خلال المتصفح أو سجلات أخطاء IIS هنا. من خلال التحقق من السجلات الموجودة في المجلد `./logs/stdout`، يمكن للمطورين تعقب مشكلات محددة، سواء كانت مرتبطة برمز التطبيق أو مشكلات تكوين البيئة.

وأخيرًا، يتحقق البرنامج النصي الرابع مما إذا كان الملف AspNetCoreModuleV2 تم تثبيته في IIS. ويتم ذلك باستخدام PowerShell مع Get-WebGlobalModule الأمر، الذي يسرد كافة الوحدات العامة المثبتة على الخادم. إذا كانت الوحدة مفقودة، فسيظهر أمر لاحق، تثبيت-WindowsFeature، يقوم بتثبيت مكونات IIS الضرورية. وهذا يضمن أن تطبيق Blazor لديه جميع التبعيات المطلوبة ليعمل بشكل صحيح. بدون هذه الوحدات، لا يمكن لتطبيقات Blazor العمل ضمن IIS، مما يؤدي إلى أخطاء في التكوين مثل 500.19. يضمن البرنامج النصي لاختبار الوحدة تطبيق أذونات الدليل وإعدادات وحدة IIS بشكل صحيح، مما يوفر طبقة إضافية من التحقق من صحة عملية النشر.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="" verb="" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath=".\BlazorApp2.exe" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>
<!--Ensure the right handler is mapped, and the processPath is correct.-->

# PowerShell script to set proper permissions for the application directory
param (
  [string]$path = "C:\inetpub\wwwroot\BlazorApp"
)
# Grant read and write permissions to IIS_IUSRS
icacls $path /grant "IIS_IUSRS:(OI)(CI)RX"
icacls $path /grant "IIS_IUSRS:(OI)(CI)(F)"
Write-Host "Permissions set successfully on $path"
# Make sure this script is run with administrative privileges.

<configuration>
  <system.webServer>
    <aspNetCore processPath=".\BlazorApp2.exe" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
  </system.webServer>
</configuration>
# After enabling logging, ensure that the "logs" folder exists in the application directory.
# Check the logs for further information on what's causing the deployment issue.
# Disable stdout logging in production to avoid performance issues.

# PowerShell script to check if IIS modules are installed
Import-Module WebAdministration
$modules = Get-WebGlobalModule | Where-Object {$_.Name -eq "AspNetCoreModuleV2"}
if ($modules -eq $null) {
  Write-Host "AspNetCoreModuleV2 is missing. Installing the module..."
  Install-WindowsFeature -Name Web-Asp-Net45
} else {
  Write-Host "AspNetCoreModuleV2 is already installed."
}

using NUnit.Framework;
namespace BlazorApp.Tests
{
  public class DeploymentTests
  {
    [Test]
    public void TestPermissionsAreSetCorrectly()
    {
      var directory = "C:\\inetpub\\wwwroot\\BlazorApp";
      var permissions = new System.Security.AccessControl.DirectorySecurity(directory, System.Security.AccessControl.AccessControlSections.All);
      Assert.IsTrue(permissions.AreAccessRulesProtected == false, "Permissions are incorrect!");
    }
  }
}
# This unit test validates whether the directory permissions are correctly set.

استكشاف تكوين IIS لعمليات نشر Blazor

عند نشر مشروع Blazor على IIS، هناك مشكلة شائعة تتمثل في التكوين غير الصحيح لوحدات IIS، وتحديدًا AspNetCoreModuleV2. هذه الوحدة مسؤولة عن استضافة تطبيقات .NET Core ضمن IIS ويجب تثبيتها بشكل صحيح. إذا كان مفقودًا، فقد يتسبب ذلك في حدوث أخطاء مثل 500.19. يعد التأكد من تمكين الإصدار الصحيح من هذه الوحدة أمرًا بالغ الأهمية لكي يعمل تطبيق Blazor بشكل صحيح. بالإضافة إلى ذلك، يمكن أن يكون التحقق من تعيين نموذج الاستضافة على "قيد المعالجة" أو "خارج العملية" أمرًا أساسيًا لحل هذه المشكلات.

هناك عامل آخر يمكن أن يؤدي إلى الخطأ 500.19 وهو عدم وجود المكونات الضرورية في البيئة المستهدفة. على سبيل المثال، قد يؤدي تشغيل تطبيق Blazor على خادم لا يحتوي على إصدار وقت تشغيل .NET المناسب المثبت إلى حدوث مشكلات في التكوين. يعد التأكد من أن الخادم يتمتع بنفس وقت تشغيل تطبيق Blazor أمرًا ضروريًا لنجاح النشر. علاوة على ذلك، يجب على المسؤولين أيضًا التحقق من استخدام تجمع التطبيقات الصحيح للموقع في IIS، خاصةً الذي تم تكوينه لاستخدام .NET Core.

إلى جانب مشكلات التكوين، تلعب أذونات المجلد دورًا مهمًا في عملية النشر. على الرغم من أنك منحت الأذونات لـ IIS_IUSRS المجموعة، قد تمنع قواعد الأمان الإضافية الوصول إلى ملفات أو أدلة محددة. يضمن التحقق من هذه الأذونات وتعديلها من خلال أدوات مثل PowerShell أو IIS Manager أن تطبيق Blazor لديه حق الوصول الكافي إلى الملفات الضرورية لعمليات وقت التشغيل. يعد الجمع بين إعداد الوحدة النمطية والتوافق في وقت التشغيل والأذونات أمرًا ضروريًا لاستكشاف أخطاء هذا الخطأ وإصلاحها.