Blazor Server端JSInterop在IIS中失效但IIS Express正常

1. 检查Blazor Hub端点配置 #

Blazor Server依赖SignalR Hub实现双向通信，JSInterop的正常运行离不开这个连接。确认Program.cs中是否正确配置了Hub路由：

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

如果自定义了Hub路径，需同步修改_Host.cshtml中的Blazor脚本引用，添加对应参数：

<script src="_framework/blazor.server.js?hubPath=/your-custom-hub-path"></script>

2. 验证IIS静态文件访问权限 #

确保IIS允许访问_framework目录下的核心文件（比如blazor.server.js）：

• 确认站点已启用静态文件功能（在IIS管理器站点的功能视图中）
• 检查web.config中没有拦截_framework路径的规则

3. 复查WebSocket与SignalR相关配置 #

即便已开启WebSocket，仍需确认以下配置：

• IIS站点的WebSocket协议已启用（IIS管理器站点功能视图中）
• 应用程序池的.NET CLR版本设为v4.0及以上，托管管道模式为集成
• web.config中正确配置SignalR支持：

<system.webServer>
  <webSocket enabled="true" />
  <handlers>
    <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
  </handlers>
  <aspNetCore processPath="dotnet" arguments=".\YourApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="InProcess" />
</system.webServer>

若使用OutOfProcess托管模式，需确保AspNetCoreModuleV2配置正确。

4. 确认JSInterop调用时机 #

Blazor组件中调用JSInterop必须在组件渲染完成后执行，比如放在OnAfterRenderAsync生命周期方法中，避免在DOM未就绪的OnInitializedAsync中调用：

protected override async Task OnAfterRenderAsync(bool firstRender)
{
    if (firstRender)
    {
        await JS.InvokeVoidAsync("alert", "Printing");
    }
}

5. 排查隐藏的连接错误 #

开启Blazor调试日志，查看更详细的连接信息：
在_Host.cshtml的Blazor脚本中添加debug参数：

<script src="_framework/blazor.server.js" debug="true"></script>

然后在浏览器控制台的网络标签下，检查SignalR的WebSocket连接（ws://或wss://开头的请求）是否成功建立，是否存在404、500等错误。

6. 检查URL重写规则 #

若站点配置了URL重写，确保规则没有拦截Blazor Hub的默认路径（/_blazor），避免请求被错误重定向或拦截。

7. 验证应用程序池权限 #

确保应用程序池的运行身份拥有足够权限访问应用目录，尤其是日志、临时文件目录，权限不足可能导致SignalR连接异常，进而影响JSInterop功能。

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