BlazorWebView控件不渲染、页面空白，大概率是MauiProgram.cs中未调用AddMauiBlazorWebView()，或App.razor中Router未指定AppAssembly；路径HostPage必须设为"wwwroot/index.html"，且需确认已安装maui和maui-blazor工作负载。
BlazorWebView控件不渲染，页面空白怎么办
大概率是 AddMauiBlazorWebView() 没注册，或者 App.razor 中的 Router 未指定 AppAssembly。
MAUI Blazor 启动时不会报错，但漏掉服务注册会导致整个 WebView 容器空转——连控制台日志都不出。这不是配置遗漏，是根本没激活 Blazor 渲染管线。
-
MauiProgram.cs中必须调用.Services.AddMauiBlazorWebView()（注意不是AddBlazorWebView()，后者是旧版别名，.NET 9 中已弃用） -
App.razor里<Router AppAssembly="@typeof(App).Assembly">缺一不可；若引用了其他程序集的组件，需显式加入AdditionalAssemblies - 检查
MainPage.xaml是否真的用了BlazorWebView控件，并设置了HostPage="wwwroot/index.html"—— 这个路径不是可选的，也不能改成/index.html或相对路径
在@code块里直接调用Android.App.Activity会崩溃
这是跨平台编译期就过不去的错误：MAUI 的目标平台是多端统一的，Android.App.Activity 在 iOS 或 Windows 上根本不存在类型定义。
Blazor Hybrid 的原生能力必须走 MAUI Essentials 抽象层，否则编译失败或运行时 System.TypeLoadException。
- 定位用
Geolocation.Default.GetLastKnownLocation()，不是Windows.Devices.Geolocation - 相册/相机统一走
MediaPicker.PickPhoto()或CapturePhotoAsync()，不用平台专属 Intent 或 UIViewController - 文件操作必须用
FileSystem.Current.AppDataDirectory，而非Environment.GetFolderPath(SpecialFolder.MyDocuments)（后者在 Android 上返回 null） - 所有权限声明仍需手动加：Android 要改
AndroidManifest.xml，iOS 要配Info.plist，不能只靠 C# 代码“请求”
dotnet new maui-blazor 创建的项目跑不起来，提示“找不到 Microsoft.AspNetCore.Components.WebView.Maui”
本质是 SDK 版本和工作负载不匹配。.NET 9 SDK 默认不带 MAUI Blazor WebView 运行时依赖，必须显式安装对应工作负载。
Visual Studio 2022 v17.12+ 虽然界面有模板，但若没勾选 “.NET Multi-platform App UI development” + “ASP.NET and web development” 两个工作负载，CLI 创建的项目照样缺引用。
- 命令行验证：运行
dotnet workload list，确认输出中包含maui和maui-blazor - 补装命令：
dotnet workload install maui maui-blazor（.NET 9 下必须同时装这两个） - 若用 VS Code，还需安装
.NET MAUI Extension并重启窗口，否则 OmniSharp 不识别BlazorWebViewXAML 元素 - Windows 桌面运行依赖 WebView2，但仅限 WPF/WinUI 主机；Android/iOS/macOS 不需要，别误装系统级 WebView2 Runtime
想在 Blazor 组件里发 HTTP 请求，该用 HttpClient 还是 JS Interop 调 fetch？
直接用 HttpClient，别绕路 JS Interop。Blazor Hybrid 的 C# 逻辑全程在原生进程内执行，HttpClient 就是标准 .NET 实现，支持 DNS、代理、证书校验全链路。
JS Interop 是为 WebAssembly 场景设计的桥接机制，在 Hybrid 里调 fetch 属于人为增加一层不可控转发，还会丢失 HttpClientHandler 配置能力。
- 注入方式：在
MauiProgram.cs中用builder.Services.AddHttpClient()，然后在@code块里构造函数注入IHttpClientFactory - 避免单例
static HttpClient：它不支持 DNS 变更重试，移动端切网络时容易卡死 - 若需拦截请求（如加 token），用
DelegatingHandler，不是靠 JS 注入 header - 本地 API 调试时，Kestrel 不启动也无所谓；真要起本地服务，用
WebApplication.CreateBuilder()手动监听http://localhost:5000即可，和 WebView 无冲突
Blazor Hybrid 最容易被忽略的点，是它既不是 Web 应用，也不是传统 MAUI 应用——它的生命周期由 MAUI 控制，但 UI 更新节奏由 Blazor 的渲染器驱动。任何试图把 Web 开发习惯（比如全局 window 对象、document.querySelector）或原生开发习惯（比如直接 new Activity）硬套进去的操作，都会在某个平台悄无声息地失败。
