Blazor Server部署IIS子应用资源加载异常及无交互问题求助

1. 显式配置子应用基础路径（解决资源加载失败） #

.NET 8 Blazor Server对应用路径的处理逻辑有调整，必须显式指定子应用的虚拟目录：

• 打开Program.cs，在UseRouting()之前添加UsePathBase配置，替换为你的实际子应用路径：

var app = builder.Build();

// 替换为IIS子应用的虚拟目录名称
app.UsePathBase("/BlazorSubApp");

app.UseRouting();

// 保持MapBlazorHub和Fallback路由的顺序
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

• 同步修改_Host.cshtml里的资源引用，统一用~/前缀确保路径正确解析，比如DevAssets的引用：

<link href="~/css/site.css" rel="stylesheet" />
<link href="~/devexpress-blazor.css" rel="stylesheet" />
<script src="~/devexpress-blazor.js"></script>

• 确认IIS子应用的应用池是集成模式，且服务器已安装并启用WebSocket协议（Windows Server 2008 R2需单独安装该组件，2012及以上版本可在IIS功能中启用）。

2. 强制指定Blazor Hub连接路径（解决无交互问题） #

即便添加了MapBlazorHub()，.NET 8可能因路径自动检测失败导致SignalR连接异常，需显式配置：

• 在Program.cs中修改Hub映射路径，带上子应用前缀：

app.MapBlazorHub("/BlazorSubApp/_blazor");

• 在_Host.cshtml中修改Blazor启动脚本，指定Hub地址：

<script src="_framework/blazor.server.js" autostart="false"></script>
<script>
  Blazor.start({
    configureSignalR: builder => {
      builder.withUrl("/BlazorSubApp/_blazor");
    }
  });
</script>

3. 适配DevExpress .NET 8兼容配置 #

确保DevAssets组件版本与.NET 8匹配，避免兼容性问题：

• 升级DevExpress至v23.2及以上版本（该版本开始全面支持.NET 8 Blazor Server）。
• 在Program.cs中注册DevExpress服务时，明确指定Bootstrap版本：

builder.Services.AddDevExpressBlazor(options => {
    options.BootstrapVersion = BootstrapVersion.v5;
});

• 发布时确认devexpress-blazor.css和devexpress-blazor.js已被正确包含在输出目录中。

4. 根目录部署无交互问题排查 #

若根目录部署时CSS正常但无交互，重点检查以下几点：

• 确认IIS站点已启用WebSocket协议，可在IIS功能视图中验证。
• 打开浏览器控制台（F12），查看Console和Network标签，排查SignalR连接是否出现404/500错误。
• 核对Program.cs中中间件顺序，确保MapBlazorHub()位于UseAuthentication()和UseAuthorization()之后：

app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

• 检查_blazor路径未被IIS请求筛选规则阻止。

额外排查步骤 #

• 部署后重启IIS应用池，清理浏览器缓存，避免旧资源残留。
• 发布时确认目标框架选择为.NET 8，根据服务器环境选择框架依赖或自包含部署模式。

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