Blazor Hybrid iOS调试与构建异常问题求助

问题现象 #

• Android平台运行正常
• iOS调试模式：闪屏后显示空白界面，无法交互
• iOS Release模式：启动瞬间闪退，无闪屏

环境信息 #

• VS Community 17.6.2
• Xcode 14.3.1
• 使用的NuGet包：
  • MudBlazor 6.7.0
  • Plugin.InAppBilling 7.0.5-beta
  • sqlite-net-pcl 1.6.292

日志信息 #

启动警告（重复4次） #

2023-08-03 11:52:20.473 mlaunch[10173:157780] Thread Pool Worker DVTAssertions: Warning in /System/Volumes/Data/SWE/Apps/DT/BuildRoots/BuildRoot7/ActiveBuildRoot/Library/Caches/com.apple.xbs/Sources/DVTFrameworks/DVTFrameworks-21780/DVTFoundation/DeveloperStructure/DVTExtendedPlatformInfo.m:79
Details:  DVTExtendedPlatformInfo: Synthesized watchos Extended Platform Info because no plugin existed to provide it or that plugin was not loaded
Object:   <DVTExtendedPlatformInfo>
Method:   +extendedPlatformInfoForPlatformIdentifier:error:
Thread:   <NSThread: 0x600001d7c680>{number = 9, name = (null)}
Please file a bug at https://feedbackassistant.apple.com with this warning message and any useful information you can provide.

Mac控制台日志 #

调试模式

error   11:44:03.707564+0100    kernel  Sandbox: App Name(1681) deny(1) sysctl-read kern.bootargs
error   11:44:03.916393+0100    kernel  Sandbox: App Name(1681) deny(2) file-test-existence /usr/bin/gdb
error   11:44:03.916500+0100    kernel  Sandbox: App Name(1681) deny(2) file-test-existence /bin/gdb
error   11:44:03.916532+0100    kernel  Sandbox: App Name(1681) deny(2) file-test-existence /sbin/gdb
error   11:44:03.916568+0100    kernel  Sandbox: App Name(1681) deny(2) file-test-existence /usr/bin/lldb
error   11:44:03.916771+0100    kernel  Sandbox: App Name(1681) deny(2) file-test-existence /bin/lldb
error   11:44:03.916856+0100    kernel  Sandbox: App Name(1681) deny(2) file-test-existence /sbin/lldb
error   11:44:06.013075+0100    backboardd  ignoring connection; bundleID is missing (or invalid) from the attributes: IOHIDEventSystemConnection uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx pid:1681 process:App Name type:Passive entitlements:0x0 caller:PencilKit: <redacted> + 76 attributes:(null) state:0x0 events:0 mask:0x0 dropped:0 dropStatus:0 droppedMask:0x0 lastDroppedTime:NONE

Release模式

error   12:52:39.950027+0100    kernel  1 duplicate report for Sandbox: App Name(1700) deny(1) sysctl-read kern.bootargs
error   12:52:39.950071+0100    kernel  Sandbox: App Name(1712) deny(2) file-test-existence /usr/bin/gdb
error   12:52:39.950115+0100    kernel  Sandbox: App Name(1712) deny(2) file-test-existence /bin/gdb
error   12:52:39.950145+0100    kernel  Sandbox: App Name(1712) deny(2) file-test-existence /sbin/gdb
error   12:52:39.950176+0100    kernel  Sandbox: App Name(1712) deny(2) file-test-existence /usr/bin/lldb
error   12:52:39.950206+0100    kernel  Sandbox: App Name(1712) deny(2) file-test-existence /bin/lldb
error   12:52:39.950246+0100    kernel  Sandbox: App Name(1712) deny(2) file-test-existence /sbin/lldb
error   12:52:40.637070+0100    backboardd  ignoring connection; bundleID is missing (or invalid) from the attributes: IOHIDEventSystemConnection uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx pid:1712 process:App Name type:Passive entitlements:0x0 caller:PencilKit: <redacted> + 76 attributes:(null) state:0x0 events:0 mask:0x0 dropped:0 dropStatus:0 droppedMask:0x0 lastDroppedTime:NONE
error   12:52:40.901303+0100    SpringBoard Advisor: No handle found for currently focused PID: 1712; sceneIdentity: com.apple.frontboard.systemappservices::FBSceneManager:sceneID%3Acom.company.appName-default
error   12:52:40.963718+0100    runningboardd   RBSStateCapture remove item called for untracked item <RBConnectionClient| 1712 name:application<com.company.appName> entitlements:<RBEntitlements| [
            
            ]> inheritanceManager:<RBClientInheritanceManager|  inheritances:[
    <RBSInheritance| environment:UIScene:com.apple.frontboard.systemappservices::FBSceneManager:sceneID%3Acom.company.appName-default name:com.apple.frontboard.visibility origID:30-31-7995 payload>,
    <RBSInheritance| environment:(none) name:com.apple.frontboard.visibility origID:30-31-7987>
    ]>>
error   12:52:41.078602+0100    SpringBoard Scene FBSceneManager/sceneID:com.company.appName-default update failed: <NSError: 0x2801942a0; domain: FBSceneErrorDomain; code: 1 (operation-failed); reason: "Scene update failed."> {
    NSUnderlyingError = <NSError: 0x2801b1c50; domain: FBWorkspace; code: 1; reason: "Scene client is invalid.">;}
error   12:52:41.081595+0100    SpringBoard Ignoring update for invalidated scene: sceneID:ccom.company.appName-default

已尝试方案 #

• 新建项目复制原有代码（原项目初始在Windows搭建），问题依旧
• 创建基础MAUI Blazor项目，运行正常
• 手动添加entitlements.plist（仅配置WiFi权限）

排查与解决方向 #

1. Bundle ID配置验证
   日志明确提示bundleID is missing (or invalid)，检查iOS项目Info.plist中的CFBundleIdentifier，确保和项目配置里的Bundle ID完全一致，无拼写错误或特殊字符。

2. 第三方NuGet包兼容性排查
   逐个移除测试：

   • 先移除Plugin.InAppBilling 7.0.5-beta（beta版本易存在适配问题），替换稳定版或暂时移除后测试iOS运行状态
   • 验证MudBlazor 6.7.0的iOS适配情况，尝试降级到更稳定的版本
   • 检查sqlite-net-pcl的初始化逻辑，确认未调用iOS沙盒禁止的系统API

3. Entitlements与权限配置

   • 检查entitlements.plist格式是否正确，无语法错误
   • 为SQLite添加文件系统访问权限验证（默认应具备，但需确认配置未被篡改）
   • 添加com.apple.security.network.client权限（部分组件可能依赖基础网络配置，即使无API调用）

4. iOS项目配置检查

   • 对比基础MAUI Blazor项目的Info.plist，检查UISceneConfiguration相关配置是否完整
   • Release模式下关闭Link All Assemblies选项，排除过度优化导致的组件初始化失败
   • 确认Xcode中调试/Release模式的签名证书配置一致

5. 跟踪Blazor初始化异常
   在Program.cs中添加日志输出：

   builder.Services.AddLogging(logging =>
   {
       logging.AddConsole();
       logging.AddDebug();
   });
   

   在iOS项目的AppDelegate.cs中添加异常捕获：

   public override bool FinishedLaunching(UIApplication app, NSDictionary options)
   {
       try
       {
           return base.FinishedLaunching(app, options);
       }
       catch (Exception ex)
       {
           Console.WriteLine($"Launch exception: {ex}");
           throw;
       }
   }
   

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