Blazor发布后Iframe加载应用基页而非指定HTML文件问题排查

这种情况我之前也遇到过，大概率是静态文件访问被身份验证拦截或者路径/发布配置出了问题，咱们一步步来排查解决：

可能的原因分析 #

• 中间件顺序错误：如果你的UseStaticFiles（静态文件中间件）放在身份验证/授权中间件之后，那么所有静态文件请求都会先经过身份验证检查。当iframe请求test.html时，可能因为没有带上有效的凭证（或者请求被中间件直接拦截），就被重定向到了登录页。
• 静态文件未正确发布：Blazor默认只发布wwwroot目录下的文件，如果你的test.html不在这个目录里，发布后服务器上根本找不到这个文件，请求会返回404，然后被路由重定向到登录页。
• 路径问题：本地运行时的相对路径./test.html在发布后可能因为应用部署位置（比如子目录）而失效，导致请求的URL不正确，最终触发重定向。

具体解决方案 #

1. 调整中间件顺序（最常见的解决方法） #

打开Program.cs，确保UseStaticFiles在UseAuthentication和UseAuthorization之前执行，这样静态文件请求不会被身份验证拦截：

var app = builder.Build();

// 先处理静态文件请求
app.UseStaticFiles();

app.UseRouting();

// 再处理身份验证和授权
app.UseAuthentication();
app.UseAuthorization();

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

app.Run();

2. 确认静态文件的发布配置 #

检查test.html是否在wwwroot目录下，如果不在，需要在项目的.csproj文件里添加配置，确保它被正确发布：

<ItemGroup>
  <Content Include="test.html">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
</ItemGroup>

之后重新发布应用，确认服务器上的发布目录里能找到test.html。

3. 修正Iframe的路径 #

尝试把相对路径改成绝对路径，比如：

<iframe src="/test.html" frameborder="0" id="test"></iframe>

如果应用部署在子目录（比如https://example.com/myapp/），可以用Blazor的NavigationManager来获取基路径，动态生成正确的URL：

@inject NavigationManager NavManager

<iframe src="@($"{NavManager.BaseUri}test.html")" frameborder="0" id="test"></iframe>

4. 单独开放特定静态文件的访问权限 #

如果你的应用需要保护大部分静态文件，但希望test.html可以公开访问，可以在Program.cs里添加如下配置，跳过该路径的身份验证检查：

// 单独处理test.html的请求，不经过身份验证
app.MapWhen(context => context.Request.Path.Equals("/test.html"), subApp =>
{
    subApp.UseStaticFiles();
});

// 其他请求继续走身份验证流程
app.UseAuthentication();
app.UseAuthorization();

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

总结 #

先优先检查中间件顺序，这是最容易踩坑的点。如果还是不行，再检查文件是否正确发布、路径是否准确，一般就能解决问题了。

内容的提问来源于stack exchange，提问作者Quiry's WebDev