.NET MAUI Hybrid安卓端启动页后出现Blazor错误弹窗求助

以下是针对问题的具体排查步骤：

1. 检查Release与Debug构建的配置差异 #

真机调试正常但Release版本报错，大概率是构建配置或优化逻辑导致：

• 调整安卓Release的Linker Behavior：在项目属性的安卓选项中，将链接行为从Link All改为Link Framework SDKs Only，避免过度链接删除Blazor或MAUI依赖的必要组件。
• 核对权限配置：SecurityException提示权限问题，检查AndroidManifest.xml是否包含必要权限（如INTERNET，Blazor WebView需此权限加载内容），新增功能对应的权限是否遗漏。

2. 排查Community Toolkit MAUI的影响 #

虽未直接使用但构建时包含，可能存在兼容性或初始化问题：

• 临时移除Community Toolkit MAUI NuGet包，重新构建Release版本测试。若报错消失，说明是工具包兼容性问题，可尝试升级至最新稳定版，或通过条件编译仅在iOS端初始化工具包：

#if IOS
builder.UseMauiCommunityToolkit();
#endif

3. 捕获Blazor的详细错误日志 #

系统bug报告信息不足，需获取Blazor的具体报错内容：

• 在Blazor的_Host.cshtml中添加ErrorBoundary组件包裹根内容，捕获并显示具体错误信息：

<ErrorBoundary>
    <ChildContent>
        @* 原页面内容 *@
    </ChildContent>
    <ErrorContent Context="ex">
        <p>Blazor错误：@ex.Message</p>
        <p>堆栈：@ex.StackTrace</p>
    </ErrorContent>
</ErrorBoundary>

• 使用adb logcat捕获安卓端详细日志，过滤Blazor相关输出：

adb logcat -s Blazor:* Maui:*

导出日志后可定位具体报错点。

4. 处理安卓原生异常 #

针对IllegalArgumentException和ParcelableException：

• 检查安卓项目中的自定义原生组件、导航参数传递，确认是否存在参数非法、对象未正确实现序列化的情况（如Intent传递不支持Parcelable的复杂对象）。
• 若使用MAUI页面导航，确保传递的参数类型符合安卓序列化要求，避免传递null或未标记可序列化的对象。

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