Виправлення помилки 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. The icacls Команда надає необхідні дозволи групі IIS_IUSRS, що є життєво важливим для програми Blazor для доступу до її каталогів і файлів. Без цих дозволів сервер може заблокувати роботу програми, що призведе до таких помилок, як 500.19. Використовуючи PowerShell, ви можете швидко встановити ці дозволи в пакетному сценарії, гарантуючи, що всі необхідні користувачі та групи мають доступ для читання та запису до папки програми.

Третє рішення зосереджено на налагодженні шляхом увімкнення протоколювання стандартного виводу в конфігурації Blazor. Включення stdoutLogEnabled допомагає фіксувати помилки виконання, записуючи їх у вказаний файл. Цей метод є критично важливим під час розгортання, оскільки багато помилок, які не видно в браузері або в журналах помилок IIS, можуть бути переловлені тут. Перевіряючи журнали в папці `./logs/stdout`, розробники можуть відстежувати певні проблеми, незалежно від того, пов’язані вони з кодом програми чи проблемами конфігурації середовища.

Нарешті, четвертий сценарій перевіряє, чи AspNetCoreModuleV2 встановлено в IIS. Це робиться за допомогою PowerShell з Get-WebGlobalModule команда, яка містить список усіх глобальних модулів, встановлених на сервері. Якщо модуль відсутній, наступна команда, Install-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. Крім того, перевірка того, що для моделі хостингу встановлено значення «inprocess» або «outofprocess», може бути ключем до вирішення цих проблем.

Іншим фактором, який може призвести до помилки 500.19, є відсутність необхідних компонентів у цільовому середовищі. Наприклад, запуск програми Blazor на сервері, на якому не встановлено відповідну версію середовища виконання .NET, може спричинити проблеми з конфігурацією. Забезпечення того самого часу роботи сервера, що й програми Blazor, має вирішальне значення для успішного розгортання. Крім того, адміністратори також повинні перевірити, чи використовується правильний пул програм для сайту в IIS, особливо той, який налаштовано на використання .NET Core.

Крім проблем конфігурації, дозволи для папок відіграють важливу роль у процесі розгортання. Хоча ви надали дозволи для IIS_IUSRS групи, додаткові правила безпеки можуть заборонити доступ до певних файлів або каталогів. Перевірка та зміна цих дозволів за допомогою таких інструментів, як PowerShell або IIS Manager, гарантує, що програма Blazor має достатній доступ до необхідних файлів для виконання операцій. Поєднання параметрів модуля, сумісності під час виконання та дозволів має вирішальне значення для усунення цієї помилки.