Åtgärda fel 500.19: Ogiltig konfigurationssida vid distribution av Blazor-projektet på IIS

Förstå konfigurationsfelet i IIS-distribution

Att distribuera ett Blazor-projekt till IIS kan vara en smidig process, men ibland uppstår fel som kan vara svåra att diagnostisera. Ett vanligt problem som utvecklare stöter på är Fel 500.19, vilket vanligtvis indikerar ett problem med konfigurationssidan. Det här felet hindrar programmet från att starta korrekt.

Fel 500.19 pekar vanligtvis på en felaktig konfiguration i web.config fil, men även efter att ha granskat den kan felet kvarstå. Denna situation kan vara frustrerande när inget verkar fel i själva konfigurationen. Utvecklare möter ofta detta när de försöker distribuera Blazor-applikationer, särskilt när felmeddelandet verkar vaga.

Utöver konfigurationsproblem kan det finnas underliggande behörighetsproblem eller saknade komponenter på servern. Till exempel kan problem med IIS-behörigheter eller en felaktigt konfigurerad miljö också utlösa detta fel. Att se till att alla nödvändiga moduler och behörigheter finns på plats är avgörande för framgångsrik implementering.

I den här artikeln kommer vi att utforska de steg du kan vidta för att felsöka Fel 500.19 och lösa konfigurationsproblem. Genom att undersöka web.config-filen, verifiera behörigheter och kontrollera serverns miljö kan du lokalisera grundorsaken till problemet.

Förstå Blazor Deployment Error Scripts

Det första skriptet som tillhandahålls är utformat för att hantera potentiella felkonfigurationer inom web.config fil, som ofta orsakar 500.19-felet i IIS. Den kritiska komponenten här är ``-hanterare, som integrerar Blazor-appen med IIS-miljön. Den här taggen dirigerar IIS till rätt applikationssökväg och säkerställer att appen körs med hjälp av AspNetCoreModuleV2 för pågående hosting. Om den här modulen inte är korrekt inställd eller konfigurerad startar inte Blazor-applikationen, vilket leder till 500.19-felet. Processvägen och loggningsparametrarna måste också vara exakta, eftersom de hjälper till att hitta den körbara filen och hantera loggutdata.

I den andra lösningen tar vi upp möjliga behörighetsproblem med PowerShell. De icacls kommandot ger nödvändiga behörigheter till gruppen IIS_IUSRS, vilket är avgörande för att Blazor-appen ska få åtkomst till dess kataloger och filer. Utan dessa behörigheter kan servern blockera programmet från att köras, vilket leder till fel som 500.19. Genom att använda PowerShell kan du snabbt ställa in dessa behörigheter i ett batchskript, vilket säkerställer att alla nödvändiga användare och grupper har läs- och skrivåtkomst till appens mapp.

Den tredje lösningen fokuserar på felsökning genom att aktivera stdout-loggning inom Blazor-konfigurationen. Aktiverar stdoutLogEnabled hjälper till att fånga körtidsfel genom att logga dem till en angiven fil. Den här metoden är kritisk under driftsättning, eftersom många fel som inte är synliga via webbläsaren eller IIS-felloggar kan fångas här. Genom att kontrollera loggarna i mappen `./logs/stdout` kan utvecklare spåra specifika problem, oavsett om de är relaterade till programkod eller miljökonfigurationsproblem.

Slutligen kontrollerar det fjärde skriptet om AspNetCoreModuleV2 är installerat i IIS. Detta görs med PowerShell med Get-WebGlobalModule kommando, som listar alla globala moduler installerade på servern. Om modulen saknas, ett efterföljande kommando, Installera-Windows-funktion, installerar de nödvändiga IIS-komponenterna. Detta säkerställer att Blazor-applikationen har alla nödvändiga beroenden för att fungera korrekt. Utan dessa moduler kan Blazor-appar inte fungera under IIS, vilket leder till konfigurationsfel som 500.19. Enhetstestskriptet säkerställer att katalogbehörigheter och IIS-modulinställningar tillämpas korrekt, vilket ger ett extra lager av validering för distributionsprocessen.

<?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.

Utforskar IIS-konfiguration för Blazor-distributioner

När du distribuerar ett Blazor-projekt på IIS är ett vanligt problem den felaktiga konfigurationen av IIS-moduler, särskilt AspNetCoreModuleV2. Den här modulen ansvarar för att vara värd för .NET Core-applikationer inom IIS och måste installeras korrekt. Om det saknas kan det orsaka fel som 500.19. Att säkerställa att rätt version av den här modulen är aktiverad är avgörande för att Blazor-appen ska fungera korrekt. Dessutom kan det vara nyckeln till att lösa dessa problem att verifiera att värdmodellen är inställd på "inprocess" eller "outofprocess".

En annan faktor som kan leda till 500.19-felet är bristen på nödvändiga komponenter i målmiljön. Att köra en Blazor-app på en server som inte har rätt .NET runtime-version installerad kan till exempel orsaka konfigurationsproblem. Att säkerställa att servern har samma körtid som Blazor-appen är avgörande för en framgångsrik implementering. Dessutom bör administratörer också verifiera att rätt programpool används för webbplatsen i IIS, särskilt en som är konfigurerad att använda .NET Core.

Förutom konfigurationsproblem spelar mappbehörigheter en viktig roll i distributionsprocessen. Även om du har gett behörigheter till IIS_IUSRS grupp kan ytterligare säkerhetsregler förhindra åtkomst till specifika filer eller kataloger. Verifiering och modifiering av dessa behörigheter med hjälp av verktyg som PowerShell eller IIS Manager säkerställer att Blazor-appen har tillräcklig tillgång till de nödvändiga filerna för körning. Kombinationen av modulinställning, körtidskompatibilitet och behörigheter är avgörande för att felsöka det här felet.