Blazor WebAssembly应用无法部署为域名子应用的排查求助

1. 正确配置客户端项目的静态资源基础路径 #

避免本地启动失败，仅在发布阶段指定静态资源的基础路径，修改client.csproj：

<PropertyGroup Condition="'$(Configuration)' == 'Release'">
    <!-- 路径需与IIS虚拟目录完全一致 -->
    <StaticWebAssetBasePath>folder/app</StaticWebAssetBasePath>
</PropertyGroup>

本地Debug模式下仍使用根路径，发布时自动将客户端资源的路径前缀设为folder/app，避免本地开发与服务器部署的配置冲突。

2. 调整服务器项目的中间件路由映射 #

在Server项目的Program.cs中，明确指定Blazor Hub和fallback文件的路径前缀，确保与虚拟目录匹配：

// 映射Blazor Hub到虚拟目录路径
app.MapBlazorHub("/folder/app/_blazor");
// 所有非文件请求fallback到虚拟目录下的index.html
app.MapFallbackToFile("/folder/app/{*path:nonfile}", "folder/app/index.html");

如果需要根据环境动态配置，可通过配置文件读取路径前缀：

var blazorBasePath = Configuration["Blazor:BasePath"] ?? "";
if (!string.IsNullOrWhiteSpace(blazorBasePath))
{
    app.MapBlazorHub($"{blazorBasePath}/_blazor");
    app.MapFallbackToFile($"{blazorBasePath}/{{*path:nonfile}}", $"{blazorBasePath}/index.html");
}
else
{
    app.MapBlazorHub();
    app.MapFallbackToFile("{*path:nonfile}", "index.html");
}

同时在appsettings.json中添加对应配置项：

{
  "Blazor": {
    "BasePath": "folder/app"
  }
}

3. 验证IIS虚拟目录配置 #

• 确保虚拟目录的物理路径指向Server项目发布后的根目录（包含wwwroot的目录）。
• 应用程序池设置为.NET 7集成模式（托管应用依赖ASP.NET Core运行时），已安装最新ASP.NET Core模块则无需额外调整。

4. 检查index.html的base标签 #

发布后确认wwwroot/folder/app/index.html中的<base>标签路径正确，应自动生成为：

<base href="/folder/app/" />

若未自动生成，可手动添加该标签，确保客户端资源加载路径与虚拟目录对齐。

本地模拟测试 #

为提前验证配置，修改Server项目的launchSettings.json，在applicationUrl后添加虚拟目录路径：

"applicationUrl": "https://localhost:5001/folder/app;http://localhost:5000/folder/app"

启动后访问https://localhost:5001/folder/app，模拟服务器环境排查潜在问题。

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