エラー 500.19 の修正: IIS での Blazor プロジェクトのデプロイ中に構成ページが無効です

解決策 1: web.config を変更して Blazor 展開エラーを解決する

ASP.NET Core 構成を使用し、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.-->

解決策 2: IIS の権限の問題を解決する

PowerShell を使用して、IIS_IUSRS グループに正しいアクセス許可があることを確認します。

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

解決策 3: 標準出力ログを使用してアプリケーションをデバッグする

ASP.NET Core の標準出力ログを使用してエラーの詳細をキャプチャします。

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

解決策 4: IIS モジュールが正しくインストールされていることを確認する

正しい IIS モジュールが Blazor アプリケーションに対して有効になっていることを確認します。

# 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."
}

解決策 5: 構成と権限の単体テスト

構成のバックエンド検証に NUnit を使用した単体テストのセットアップ。

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 の展開の問題に関するよくある質問

1. IIS のエラー 500.19 は何を意味しますか?
2. エラー 500.19 は、無効な構成が存在することを示します。 web.config ファイルが原因で、IIS が要求を処理できなくなります。
3. Blazor デプロイにおける AspNetCoreModuleV2 とは何ですか?
4. の AspNetCoreModuleV2 は、IIS 内で .NET Core アプリケーションをホストするための主要なモジュールです。 Blazor アプリケーションを IIS と統合し、ネイティブに実行できるようにします。
5. トラブルシューティングのために標準出力ログを有効にするにはどうすればよいですか?
6. 標準出力ログを有効にするには、次のように設定する必要があります。 stdoutLogEnabled 真実に web.config ファイル。これは、展開中の実行時エラーを捕捉するのに役立ちます。
7. IIS が Blazor アプリを実行するにはどのようなアクセス許可が必要ですか?
8. IIS_IUSRS グループには、アプリケーションのディレクトリに対する読み取り、書き込み、および実行のアクセス許可が必要です。これは次を使用して構成できます。 icacls。
9. 必要な .NET ランタイムがサーバーにインストールされているかどうかを確認するにはどうすればよいですか?
10. 次のコマンドを実行して、インストールされている .NET ランタイムを確認できます。 dotnet --info サーバー上で。これにより、利用可能なすべてのランタイム バージョンが表示されます。

Blazor 展開エラーの解決

結論として、500.19 などの Blazor 展開エラーのトラブルシューティングには、両方のコンポーネントを徹底的に検査する必要があります。 web.config ファイルとサーバー環境。正しいモジュールが IIS にインストールされていることを確認し、アクセス許可を確認することが重要です。

さらに、ログ記録を有効にし、PowerShell を使用して権限を確認すると、隠れた問題が明らかになる可能性があります。これらの各領域に慎重に対処することで、構成エラーを排除し、Blazor アプリケーションを正常にデプロイできます。