MAUI+Blazor项目中Blazor JavaScript初始化器无法加载的问题

以下是排查和解决的关键点：

• 确认文件名与项目AssemblyName完全匹配
  文件名必须严格遵循{AssemblyName}.lib.module.js格式，打开项目的.csproj文件，查看<AssemblyName>节点的值，确保文件名前缀和它完全一致（包括大小写）。比如你的项目AssemblyName是MauiBlazorTemplate，那文件名必须是MauiBlazorTemplate.lib.module.js，不要使用module.lib.js后缀。

• 设置文件的复制属性
  右键wwwroot下的JS文件，选择“属性”，将“复制到输出目录”设置为如果较新则复制或始终复制，否则MAUI打包时不会将该文件包含到应用中。

• 调整调试方式，查看正确的日志输出
  MAUI Blazor的WebView中alert可能被系统拦截，优先用console.log调试：

  • Windows平台：运行项目后按F12打开WebView2的开发者工具，查看Console标签页
  • 其他平台：在Visual Studio的“输出”窗口中，选择调试目标为你的MAUI应用，查看日志输出

• 确认文件位置与Blazor启动脚本
  确保JS文件放在wwwroot根目录下，不要嵌套子文件夹。同时确认wwwroot/index.html中的Blazor启动脚本是<script src="_framework/blazor.webview.js"></script>，这是MAUI Blazor的默认启动脚本，无需额外修改。

• 验证钩子函数拼写
  确保导出的函数名是afterStarted，拼写完全正确，这是Blazor初始化器的标准钩子函数名，大小写不能出错。

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