Blazor 8发布后无index.html，部署静态Web应用遇问题求助

1. 问题根源 #

Blazor 8默认的Interactive Server或Auto渲染模式依赖服务器运行，发布后不会生成静态index.html文件。而静态Web平台要求的是纯静态托管的Blazor应用（WebAssembly模式或静态SSR模式），这类模式才会生成所需的index.html。

2. 针对性解决方案 #

方案一：切换为WebAssembly模式部署 #

修改项目文件（.csproj），确保配置为WebAssembly托管模型：

<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <StaticWebAssetBasePath>/</StaticWebAssetBasePath>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="8.0.*" />
    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="8.0.*" PrivateAssets="all" />
  </ItemGroup>
</Project>

修改后重新执行发布命令，输出目录会自动生成index.html及配套的静态资源。

方案二：保留静态SSR模式并生成index.html #

若需使用静态服务器端渲染（SSR），在发布时添加静态资源生成配置：

• 终端执行发布命令：

dotnet publish -c Release -p:BlazorEnableStaticWebAssets=true -p:StaticWebAssetBasePath=/

• 或在.csproj中添加永久配置，避免每次发布重复输入参数：

<PropertyGroup>
  <BlazorEnableStaticWebAssets>true</BlazorEnableStaticWebAssets>
  <StaticWebAssetBasePath>/</StaticWebAssetBasePath>
</PropertyGroup>

3. 修复手动添加index.html无效的问题 #

手动添加的文件无法关联Blazor应用，是因为缺少运行时引用，正确的index.html模板需包含以下内容（替换[YourProjectName]为实际项目名称）：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>你的应用名称</title>
    <base href="/" />
    <link rel="stylesheet" href="bootstrap/bootstrap.min.css" />
    <link rel="stylesheet" href="app.css" />
    <link rel="stylesheet" href="[YourProjectName].styles.css" />
</head>
<body>
    <div id="app">加载中...</div>
    <script src="_framework/blazor.webassembly.js"></script>
</body>
</html>

确保发布后的输出目录中存在_framework文件夹，才能正确加载Blazor运行时。

4. 验证发布结果 #

发布完成后检查输出目录，确认index.html与_framework目录同时存在，再部署到静态Web平台即可正常运行。

内容的提问来源于stack exchange，提问作者JTO