.NET 8 Blazor Web App IIS调试时dotnet.js加载失败求助

核心原因 #

这个问题的本质是调试构建与发布构建的静态文件路径差异，以及IIS对调试模式下Blazor Web App文件结构的适配问题：

1. .NET 8 Blazor Web App在调试模式下，WebAssembly相关的dotnet.js会生成在项目的bin/Debug/net8.0/wwwroot/_framework目录下，而非项目根目录的wwwroot。如果你的IIS站点物理路径直接指向项目根目录的wwwroot，自然会找不到该文件。
2. IIS Express由Visual Studio自动配置，会自动映射调试构建的输出路径，而手动配置的IIS默认不会处理这种调试模式下的路径映射。
3. 自动渲染模式的Blazor Web App会根据页面交互动态决定是否加载WebAssembly模块（触发dotnet.js的请求），发布构建时所有静态文件会被打包到wwwroot/_framework，因此不会出现404。

解决办法 #

1. 调整IIS站点的物理路径 #

将IIS站点的物理路径直接指向调试构建的输出目录：

• 路径示例：你的项目路径/bin/Debug/net8.0/wwwroot
• 这样IIS就能直接访问到调试模式下生成的dotnet.js文件。

2. 配置ASP.NET Core Hosting Bundle与Web.config #

• 确保服务器已安装ASP.NET Core 8.0 Hosting Bundle，它包含了IIS所需的ASP.NET Core模块，能正确处理Blazor的动态文件请求。
• 调试模式下，手动将项目bin/Debug/net8.0目录下的web.config复制到IIS站点的物理路径根目录，该配置文件包含了正确的反向代理规则，能引导IIS处理Blazor的框架文件请求。

3. 手动同步调试构建的静态文件 #

如果你希望保持IIS站点物理路径指向项目根目录的wwwroot，可以在每次调试构建后，将bin/Debug/net8.0/wwwroot/_framework目录下的所有文件（包括dotnet.js）复制到项目根目录的wwwroot/_framework中。

• 可以通过添加项目的预构建/后构建事件自动完成这个操作，示例命令：

  xcopy "$(ProjectDir)bin\Debug\net8.0\wwwroot\_framework" "$(ProjectDir)wwwroot\_framework" /E /Y /I
  

4. 验证静态文件中间件配置 #

确保Program.cs中已正确配置静态文件中间件，且顺序在Blazor路由之前：

var builder = WebApplication.CreateBuilder(args);

// 添加服务...

var app = builder.Build();

// 先配置静态文件
app.UseStaticFiles();

// 再配置Blazor路由
app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode()
    .AddInteractiveWebAssemblyRenderMode()
    .AddAdditionalAssemblies(typeof(Client._Imports).Assembly);

app.Run();

关于调试会话中dotnet.js的加载逻辑 #

调试会话中dotnet.js并非不会加载，它的加载时机由Blazor自动渲染模式的逻辑决定：当页面需要切换到WebAssembly交互模式时（比如用户触发了需要Wasm处理的交互），框架会动态请求该文件。
之所以IIS Express下不会报错，是因为Visual Studio自动为IIS Express配置了路径映射，将调试构建的输出目录作为静态文件源，而手动配置的IIS默认没有这个逻辑。

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