Blazor Hybrid是否支持NativeAOT？VS2026项目运行加载异常

核心结论 #

Blazor Hybrid目前针对.NET 10/Visual Studio 2026的版本尚未正式支持NativeAOT，官方未完成该场景的兼容性适配，这是你启用NativeAOT后HTML页面无法加载的根本原因。

问题原因 #

Blazor Hybrid在Windows平台依赖WebView2组件，其内部初始化逻辑、Razor组件渲染流程存在部分依赖动态加载或JIT编译的环节。而NativeAOT是全静态编译模式，会剔除所有JIT相关的运行时逻辑，导致Blazor无法正常加载HTML资源与渲染组件——即使构建过程无报错，运行时也会因为缺失必要的动态加载能力而失效。

可行替代方案 #

• 禁用NativeAOT：暂时回退到常规发布模式，移除项目文件中的<PublishAot>配置，确保Blazor Hybrid的所有功能正常运行。
• 使用ReadyToRun (R2R)编译：如果需要提升启动速度或性能，R2R是更兼容的提前编译方案，它不会完全禁用动态逻辑，能在保证功能的前提下优化性能。配置方式如下：

  <PublishReadyToRun Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'">True</PublishReadyToRun>
  

• 等待官方支持：微软正在逐步推进.NET生态对NativeAOT的覆盖，后续.NET版本可能会完善Blazor Hybrid的NativeAOT兼容性，可关注官方更新动态。

内容的提问来源于stack exchange，提问作者Felix F Xu