修复错误 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：使用 stdout 日志调试应用程序

使用 ASP.NET Core stdout 日志捕获错误详细信息。

<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 模块安装正确

验证是否为 Blazor 应用程序启用了正确的 IIS 模块。

# 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 部署错误

总而言之，对 Blazor 部署错误（例如 500.19）进行故障排除需要彻底检查 网络配置 文件和服务器环境。确保 IIS 中安装了正确的模块并检查权限至关重要。

此外，启用日志记录并使用 PowerShell 验证权限可以发现隐藏的问题。通过仔细解决每个领域的问题，您可以消除配置错误并成功部署 Blazor 应用程序。