Исправление ошибки 500.19: страница конфигурации недействительна при развертывании проекта Blazor в IIS

Понимание ошибки конфигурации при развертывании IIS

Развертывание проекта Blazor в IIS может быть простым процессом, но иногда возникают ошибки, которые трудно диагностировать. Одной из распространенных проблем, с которыми сталкиваются разработчики, является Ошибка 500.19, что обычно указывает на проблему со страницей конфигурации. Эта ошибка препятствует правильному запуску приложения.

Ошибка 500.19 обычно указывает на неправильную конфигурацию веб.конфигурация файл, но даже после его просмотра ошибка может сохраниться. Эта ситуация может разочаровать, если в самой конфигурации нет ничего неправильного. Разработчики часто сталкиваются с этим при попытке развернуть приложения Blazor, особенно когда сообщение об ошибке кажется расплывчатым.

Помимо проблем с конфигурацией, могут быть проблемы с разрешениями или отсутствие компонентов на сервере. Например, проблемы с разрешениями IIS или неправильно настроенной средой также могут вызвать эту ошибку. Обеспечение наличия всех необходимых модулей и разрешений имеет решающее значение для успешного развертывания.

В этой статье мы рассмотрим действия, которые можно предпринять для устранения неполадок. Ошибка 500.19 и решить проблемы с конфигурацией. Изучив файл web.config, проверив разрешения и среду сервера, вы сможете определить основную причину проблемы.

Понимание сценариев ошибок развертывания Blazor

Первый предоставленный сценарий предназначен для обработки потенциальных неправильных конфигураций в веб.конфигурация файл, который часто вызывает ошибку 500.19 в IIS. Критическим компонентом здесь является `` обработчик, который интегрирует приложение Blazor со средой IIS. Этот тег направляет IIS на правильный путь к приложению и гарантирует, что приложение запускается с использованием AspNetCoreModuleV2 для незавершенного хостинга. Если этот модуль установлен или настроен неправильно, приложение Blazor не запустится, что приведет к ошибке 500.19. Путь к процессу и параметры журналирования также должны быть точными, поскольку они помогают найти исполняемый файл и управлять выводами журнала.

Во втором решении мы решаем возможные проблемы с разрешениями с помощью PowerShell. icacls Команда предоставляет необходимые разрешения группе IIS_IUSRS, которая жизненно важна для доступа приложения Blazor к своим каталогам и файлам. Без этих разрешений сервер может заблокировать запуск приложения, что приведет к таким ошибкам, как 500.19. Используя PowerShell, вы можете быстро установить эти разрешения в пакетном сценарии, гарантируя, что все необходимые пользователи и группы будут иметь доступ для чтения и записи к папке приложения.

Третье решение ориентировано на отладку путем включения ведения журнала stdout в конфигурации 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, гарантирует, что приложение Blazor имеет достаточный доступ к необходимым файлам для операций во время выполнения. Сочетание настройки модуля, совместимости среды выполнения и разрешений имеет решающее значение для устранения этой ошибки.