Blazor WebAssembly 加载文件失败出现404 Not Found错误

架构老林

2026-9-28

Blazor WASM + VS2022 Preview 运行返回404 修复方案

这个问题是VS2022早期预览版的已知Bug，由热重载调试代理和Blazor静态文件路由冲突导致，可通过以下方案解决：

方案1：更新VS2022 Preview到最新版本
该问题在17.0 Preview 5及之后的版本已经官方修复，直接在Visual Studio Installer中升级预览版到最新版即可解决，同时不会影响.NET 6热重载功能的使用。

方案2：修改launchSettings.json配置

打开项目Properties目录下的launchSettings.json文件，在你使用的启动配置节点中添加"hotReloadProfile": "aspnetcore"配置即可，参考配置示例：

"profiles": {
  "http": {
    "commandName": "Project",
    "dotnetRunMessages": true,
    "launchBrowser": true,
    "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
    "applicationUrl": "http://localhost:5000",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    },
    "hotReloadProfile": "aspnetcore"
  }
}