如何本地运行Blazor WebAssembly？发布后无法从文件系统启动怎么办？

结论 #

直接通过文件系统（file://协议）打开发布后wwwroot目录下的index.htm来运行Blazor WebAssembly应用不可行，这是由Blazor WASM的运行机制和浏览器安全限制决定的。

原因 #

• Blazor WASM启动时需要通过HTTP请求加载.NET运行时文件、应用程序集及相关资源，file://协议无法支持这类请求的正确解析与响应。
• 浏览器的同源策略限制了file://协议下的跨资源访问，导致脚本无法正常加载和执行，出现截图中的资源加载失败错误。
• 多数浏览器会限制file://协议下的高级脚本权限，无法完成Blazor运行环境的初始化流程。

可行的解决办法 #

你需要通过HTTP服务器托管发布后的wwwroot目录，以下是几种简易方案：

• 使用.NET官方工具dotnet serve
  1. 先安装工具：dotnet tool install -g dotnet-serve
  2. 进入发布后的wwwroot目录，执行命令：dotnet serve
  3. 在浏览器中访问http://localhost:5000即可运行应用
• 使用Python简易HTTP服务器
  • 若安装了Python 3，进入wwwroot目录后执行：python -m http.server 5000
  • 若为Python 2，执行：python -m SimpleHTTPServer 5000
  • 访问http://localhost:5000启动应用
• 使用正式Web服务器
  可以配置IIS、Nginx、Apache等Web服务器，将静态文件根目录指向发布后的wwwroot目录，通过服务器域名或本地地址访问应用。

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