Virheen 500.19 korjaaminen: Määrityssivu on virheellinen Blazor-projektin käyttöönoton yhteydessä IIS:ssä

IIS-asennuksen määritysvirheen ymmärtäminen

Blazor-projektin käyttöönotto IIS:ssä voi olla sujuva prosessi, mutta joskus ilmenee virheitä, joita voi olla vaikea diagnosoida. Yksi yleinen kehittäjien kohtaama ongelma on Virhe 500.19, mikä yleensä tarkoittaa ongelmaa asetussivulla. Tämä virhe estää sovellusta käynnistymästä oikein.

Virhe 500.19 viittaa yleensä virheelliseen kokoonpanoon web.config tiedostoa, mutta virhe saattaa jatkua sen tarkistamisen jälkeenkin. Tämä tilanne voi olla turhauttavaa, kun itse kokoonpanossa ei näy mitään vikaa. Kehittäjät kohtaavat tämän usein yrittäessään ottaa käyttöön Blazor-sovelluksia, varsinkin kun virheilmoitus näyttää epämääräiseltä.

Määritysongelmien lisäksi taustalla voi olla lupaongelmia tai palvelimelta puuttuu komponentteja. Esimerkiksi IIS-käyttöoikeuksiin liittyvät ongelmat tai väärin määritetty ympäristö voivat myös laukaista tämän virheen. Onnistuneen käyttöönoton kannalta on tärkeää varmistaa, että kaikki tarvittavat moduulit ja käyttöoikeudet ovat paikallaan.

Tässä artikkelissa tutkimme vianmäärityksen vaiheita Virhe 500.19 ja ratkaise kokoonpanoongelmia. Tutkimalla web.config-tiedostoa, tarkistamalla käyttöoikeudet ja tarkistamalla palvelinympäristön voit määrittää ongelman perimmäisen syyn.

Blazorin käyttöönottovirheskriptien ymmärtäminen

Ensimmäinen toimitettu komentosarja on suunniteltu käsittelemään mahdollisia virheellisiä määrityksiä web.config tiedosto, joka aiheuttaa usein 500.19-virheen IIS:ssä. Kriittinen komponentti tässä on `Käsittelijä, joka integroi Blazor-sovelluksen IIS-ympäristöön. Tämä tunniste ohjaa IIS:n oikeaan sovelluspolkuun ja varmistaa, että sovellus toimii käyttämällä AspNetCoreModuleV2 prosessinaikaiseen isännöintiin. Jos tätä moduulia ei ole asetettu tai määritetty oikein, Blazor-sovellus ei käynnisty, mikä johtaa 500.19-virheeseen. Prosessipolun ja lokiparametrien on myös oltava tarkkoja, koska ne auttavat paikantamaan suoritettavan tiedoston ja hallitsemaan lokitulosteita.

Toisessa ratkaisussa käsittelemme mahdollisia käyttöoikeusongelmia PowerShellin avulla. The icacls komento antaa tarvittavat luvat IIS_IUSRS-ryhmälle, mikä on välttämätöntä Blazor-sovellukselle pääsyn hakemistoihin ja tiedostoihin. Ilman näitä oikeuksia palvelin voi estää sovelluksen toiminnan, mikä johtaa virheisiin, kuten 500.19. PowerShellin avulla voit määrittää nämä käyttöoikeudet nopeasti eräkomentosarjassa ja varmistaa, että kaikilla tarvittavilla käyttäjillä ja ryhmillä on luku- ja kirjoitusoikeudet sovelluksen kansioon.

Kolmas ratkaisu keskittyy virheenkorjaukseen ottamalla käyttöön stdout-kirjauksen Blazor-kokoonpanossa. Otetaan käyttöön stdoutLogEnabled auttaa kaappaamaan ajonaikaiset virheet kirjaamalla ne määritettyyn tiedostoon. Tämä menetelmä on kriittinen käyttöönoton aikana, koska monet virheet, jotka eivät näy selaimen tai IIS-virhelokien kautta, voidaan saada tästä. Tarkistamalla lokit `./logs/stdout`-kansiossa kehittäjät voivat jäljittää tiettyjä ongelmia, liittyivätpä ne sovelluskoodiin tai ympäristön määritysongelmiin.

Lopuksi neljäs komentosarja tarkistaa, onko AspNetCoreModuleV2 on asennettu IIS:ään. Tämä tehdään PowerShellin avulla Get-WebGlobalModule -komento, joka luettelee kaikki palvelimelle asennetut globaalit moduulit. Jos moduuli puuttuu, seuraava komento, Asenna-Windows-ominaisuus, asentaa tarvittavat IIS-komponentit. Tämä varmistaa, että Blazor-sovelluksella on kaikki tarvittavat riippuvuudet toimiakseen kunnolla. Ilman näitä moduuleja Blazor-sovellukset eivät voi toimia IIS:ssä, mikä johtaa määritysvirheisiin, kuten 500.19. Yksikkötestauskomentosarja varmistaa, että hakemiston käyttöoikeudet ja IIS-moduuliasetukset on otettu käyttöön oikein, mikä tarjoaa ylimääräisen vahvistuskerroksen käyttöönottoprosessille.

<?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-määritysten tutkiminen Blazor-käyttöönottoa varten

Kun Blazor-projekti otetaan käyttöön IIS:ssä, yksi yleinen ongelma on IIS-moduulien, erityisesti AspNetCoreModuleV2. Tämä moduuli vastaa .NET Core -sovellusten ylläpidosta IIS:ssä, ja se on asennettava oikein. Jos se puuttuu, se voi aiheuttaa virheitä, kuten 500.19. Tämän moduulin oikean version varmistaminen on erittäin tärkeää, jotta Blazor-sovellus toimii oikein. Lisäksi sen varmistaminen, että isännöintimalli on asetettu tilaan "inprocess" tai "outofprocess", voi olla avainasemassa näiden ongelmien ratkaisemisessa.

Toinen tekijä, joka voi johtaa 500.19-virheeseen, on tarvittavien komponenttien puute kohdeympäristössä. Esimerkiksi Blazor-sovelluksen käyttäminen palvelimella, johon ei ole asennettu asianmukaista .NET-ajonaikaista versiota, voi aiheuttaa määritysongelmia. Onnistuneen käyttöönoton kannalta on tärkeää varmistaa, että palvelimella on sama käyttöaika kuin Blazor-sovelluksella. Lisäksi järjestelmänvalvojien tulee myös varmistaa, että IIS:n sivustossa käytetään oikeaa sovelluspoolia, erityisesti sellaista, joka on määritetty käyttämään .NET Corea.

Määritysongelmien lisäksi kansioiden käyttöoikeuksilla on tärkeä rooli käyttöönottoprosessissa. Vaikka olet myöntänyt käyttöoikeudet IIS_IUSRS ryhmässä, lisäturvasäännöt voivat estää pääsyn tiettyihin tiedostoihin tai hakemistoihin. Näiden käyttöoikeuksien tarkistaminen ja muokkaaminen työkaluilla, kuten PowerShell tai IIS Manager, varmistaa, että Blazor-sovelluksella on riittävät käyttöoikeudet tarvittaviin tiedostoihin ajonaikaisia ​​toimintoja varten. Moduuliasetusten, ajonaikaisen yhteensopivuuden ja käyttöoikeuksien yhdistelmä on ratkaisevan tärkeä tämän virheen vianetsinnän kannalta.