MAUI Blazor 中 OnInitializedAsync 等生命周期方法虽存在，但触发早于 WebView 初始化，无法安全调用 JSRuntime 或访问 DOM；必须等待 WebViewInitialized 事件后操作，并通过 MAUI 页面事件协同刷新状态。
MAUI Blazor 中没有 OnInitializedAsync 等标准 Blazor 生命周期方法
在 MAUI 中嵌入 Blazor（即 BlazorWebView）时，组件运行在 .NET MAUI 宿主进程内，而非服务器或 WebAssembly 沙箱。这意味着 OnInitializedAsync、OnParametersSetAsync、OnAfterRenderAsync 这些 Blazor 标准生命周期方法依然存在并会被调用，但它们的触发时机和上下文与 Web 场景有关键差异：它们不反映 UI 渲染完成、不保证原生控件已就绪，且无法响应 MAUI 页面级导航事件。
常见错误现象是：在 OnInitializedAsync 中调用 JSRuntime.InvokeVoidAsync 或访问 ElementRef，结果抛出 NullReferenceException 或静默失败——因为此时 BlazorWebView 的内部 WebView 尚未加载完毕，JS 上下文不可用。
-
OnInitializedAsync在组件实例化后立即执行，早于 MAUI 页面的OnAppearing -
OnAfterRenderAsync可能被多次调用，但不对应原生视图“首次绘制完成” - 无法通过 Blazor 组件自身监听 MAUI 页面的
Appearing/Disappearing事件
如何在 MAUI Blazor 中安全访问 JSRuntime 和原生 UI
必须等待 BlazorWebView 的 WebViewInitialized 事件触发后，才能安全使用 JSRuntime 或操作 DOM 元素。这个事件由 MAUI 控件发出，早于任何 Blazor 组件的生命周期方法执行。
实操建议：
- 在 MAUI 页面（如
MainPage.xaml.cs）中订阅blazorWebView.WebViewInitialized，保存WebViewController或直接调用InvokeAsync初始化 JS 模块 - 不要在 Blazor 组件的
OnInitializedAsync中调用JSRuntime；改用OnAfterRenderAsync(firstRender)+ 标志位控制，仅在firstRender == true且确认WebViewInitialized已触发后执行 JS 调用 - 若需响应页面显示/隐藏，应在 MAUI 页面的
OnAppearing/OnDisappearing中通过JSRuntime向 Blazor 组件发消息（例如用DotNetObjectReference注入回调）
示例（MAUI 页面端）：
blazorWebView.WebViewInitialized += (s, e) =>
{
var js = e.WebView;
_jsRuntime = new JSRuntime(js);
// 此时可安全调用 _jsRuntime.InvokeVoidAsync("initApp");
};
MAUI 页面生命周期与 Blazor 组件生命周期如何协同
Blazor 组件在 MAUI 中是“静态挂载”的：只要 BlazorWebView 存活，组件树不会因 MAUI 页面导航而自动销毁重建（除非手动替换 HostPage）。这导致 OnInitializedAsync 只在首次加载时执行一次，后续页面返回不会重新触发。
典型问题场景：用户从列表页（List.razor）导航到详情页（Detail.razor），再按返回键回到列表页——列表页组件未重建，OnParametersSetAsync 也不会被调用，状态残留。
- 解决数据刷新问题，不能依赖生命周期方法，而应监听 MAUI 导航事件，再通过
StateHasChanged()或参数重绑定触发更新 - 推荐模式：在 MAUI 页面的
OnAppearing中，调用 Blazor 组件公开的公共方法（如RefreshDataAsync()），该方法内部调用StateHasChanged()并重新拉取数据 - 避免在组件中持有跨页面的单例服务状态，除非明确设计为全局缓存
调试 BlazorWebView 生命周期的关键信号
没有日志，很难判断当前 JS 上下文是否可用、组件是否真正渲染完成。最可靠的调试点是三个时间戳：
-
BlazorWebView.WebViewInitialized事件 —— JS 运行时就绪 - Blazor 组件中
OnAfterRenderAsync(true)—— 首次 HTML 渲染完成（但 DOM 可能尚未被 WebView 解析） - 在 JS 端监听
DOMContentLoaded或document.readyState === 'complete'，再通过DotNet.invokeMethodAsync回调通知 C#
容易忽略的是：MAUI 的 BlazorWebView 在 Android/iOS 上启动 WebView 有明显延迟，WebViewInitialized 触发后仍可能需要几十毫秒才能稳定执行 JS。生产环境建议加简单重试逻辑（如 await Task.Delay(50) 后再调 JS），或封装成带超时的 WaitForJsReadyAsync() 方法。
