.NET MAUI Blazor Hybrid 应用在.NET 10中的加载问题解析

在.NET 10预览版1中，开发人员在使用MAUI Blazor Hybrid应用模板时遇到了一个棘手的加载问题。本文将深入分析该问题的成因、影响范围以及解决方案。

问题现象

当开发者在.NET 10预览版1环境下创建并运行MAUI Blazor Hybrid应用时，应用会陷入持续加载状态而无法正常启动。这个问题在多个平台上表现一致：

• 同时影响Windows、MacOS开发环境
• 在Android模拟器和iOS模拟器上同样出现
• 仅影响.NET 10预览版1，.NET 9.0项目不受影响
• 仅影响Blazor Hybrid应用，普通MAUI应用和MAUI Blazor Hybrid Web应用不受影响

问题根源

经过微软开发团队的调查，发现问题的核心在于Blazor WebView组件在.NET 10预览版1中的实现存在一个关键缺陷。具体来说：

1. 应用启动时，Blazor WebView需要加载一个名为"blazor.modules.json"的配置文件
2. 在.NET 10预览版1中，这个文件没有被正确包含在构建过程中
3. 导致WebView组件无法获取必要的模块信息，从而陷入无限加载状态

解决方案

微软团队已经在新版本中修复了这个问题。对于不同情况，开发者可以采取以下措施：

1. 升级到.NET 10预览版2

最彻底的解决方案是升级到.NET 10预览版2或更高版本。新版本已经包含了修复代码，无需任何额外配置即可正常工作。

2. 临时解决方案（仅适用于预览版1）

如果暂时无法升级，可以在项目文件中添加以下MSBuild目标作为临时解决方案：

<Target Name="_Maui_Before_AddBlazorWebViewAssets"
  BeforeTargets="_AddBlazorWebViewAssets"
  DependsOnTargets="_MauiAddEmptyBlazorModulesJson"
  Condition="'$(_MauiSkipAddEmptyBlazorModulesJson)' != 'true'" />

<Target Name="_MauiAddEmptyBlazorModulesJson" Condition="'@(_ExistingBuildJSModules)' == ''">
  <PropertyGroup>
    <_MauiBlazorWebViewModulesJsonPath>$(IntermediateOutputPath)blazor.modules.json</_MauiBlazorWebViewModulesJsonPath>
  </PropertyGroup>
  <WriteLinesToFile File="$(_MauiBlazorWebViewModulesJsonPath)" Lines="[]" Overwrite="true" WriteOnlyWhenDifferent="True" />
  <ItemGroup>
    <FileWrites Include="$(_MauiBlazorWebViewModulesJsonPath)" />
  </ItemGroup>
  <ItemGroup>
    <_WebViewAssetCandidates Include="$(_MauiBlazorWebViewModulesJsonPath)">
      <RelativePath>_framework/blazor.modules.json</RelativePath>
    </_WebViewAssetCandidates>
  </ItemGroup>
</Target>

这段代码会在构建过程中自动创建一个空的blazor.modules.json文件，确保WebView组件能够正常加载。

注意事项

1. 对于WinForms和WPF的Blazor Hybrid应用，同样存在类似问题，但仅限于.NET 10预览版1
2. 临时解决方案中的空JSON文件内容应为"[]"，这是Blazor模块系统预期的格式
3. 升级到预览版2后，应移除临时解决方案代码，以避免潜在的构建冲突

总结

这个问题展示了框架升级过程中可能遇到的兼容性挑战。微软团队快速响应并修复了这个问题，体现了.NET生态系统的成熟度。对于开发者来说，及时关注框架更新和已知问题列表，可以有效避免类似问题的困扰。

在开发过程中遇到框架级问题时，建议：

1. 首先检查是否是最新版本
2. 查阅官方问题跟踪系统
3. 考虑使用临时解决方案作为过渡
4. 及时升级到修复版本以获得最佳开发体验