.NET 8 Blazor Server部署IIS子站点时静态文件路径错误求助

核心问题原因 #

应用未识别子站点的虚拟路径，导致静态文件请求直接指向根站点，而非子站点路径下的资源。

具体解决步骤 #

1. 配置应用基础路径（Base Path） #

在Program.cs中添加UsePathBase中间件，指定IIS子站点的虚拟路径，且必须放在UseStaticFiles之前：

var app = builder.Build();

// 对应IIS子站点的虚拟路径，比如"/virtual-path-to-subsite"
app.UsePathBase("/virtual-path-to-subsite");

// 后续中间件...
app.UseStaticFiles();
app.UseRouting();
// ...其他Blazor相关中间件

同时修改wwwroot/index.html中的<base>标签，匹配虚拟路径（注意末尾必须加斜杠）：

<base href="/virtual-path-to-subsite/" />

2. 正确配置静态文件中间件 #

无需修改UseStaticFiles的物理路径参数——IIS子站点的物理路径已映射到你的Blazor应用发布目录，静态文件中间件默认会读取应用自身的wwwroot文件夹。确保中间件顺序正确：UsePathBase → UseStaticFiles → UseRouting → Blazor Hub/路由映射。

3. 检查IIS子站点配置 #

• 确认子站点的物理路径指向Blazor应用的发布根目录（包含wwwroot、web.config等文件的目录）。
• 确认子站点的虚拟路径与代码中UsePathBase设置的路径完全一致（包括大小写）。
• 确保IIS服务器已启用静态文件功能（可在IIS管理器的站点功能视图中开启）。

4. 修正静态文件引用路径 #

页面或组件中引用静态文件时，使用相对路径而非绝对路径：

• 错误写法：<link rel="stylesheet" href="/site.css" />（会直接请求根站点）
• 正确写法：<link rel="stylesheet" href="site.css" />（会基于<base>标签的路径拼接为/virtual-path-to-subsite/site.css）

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