迁移Xamarin iOS绑定库至.NET 6时崩溃，如何排查？

云原生阿岚

2026-7-28

问题

将Xamarin iOS绑定库迁移至.NET 6，运行已迁移至MAUI且在Android端可正常运行的示例应用时，出现如下SIGABRT原生崩溃，堆栈跟踪未显示具体崩溃位置及原因，该如何排查？

=================================================================
    Native Crash Reporting
=================================================================
Got a SIGABRT while executing native code. This usually indicates
a fatal error in the mono runtime or one of the native libraries 
used by your application.
=================================================================

=================================================================
    Native stacktrace:
=================================================================
    0x1032ff3e0 - /private/var/containers/Bundle/Application/F89D0267-2709-444E-A12D-D8C5FD797B03/SimpleDemo.app/SimpleDemo : _ZNK3icu6number23NumberFormatterSettingsINS0_24LocalizedNumberFormatterEE10toSkeletonER10UErrorCode
    0x1032ea4dc - /private/var/containers/Bundle/Application/F89D0267-2709-444E-A12D-D8C5FD797B03/SimpleDemo.app/SimpleDemo : _ZNK3icu6number23NumberFormatterSettingsINS0_24LocalizedNumberFormatterEE10toSkeletonER10UErrorCode
    0x1034117e4 - /private/var/containers/Bundle/Application/F89D0267-2709-444E-A12D-D8C5FD797B03/SimpleDemo.app/SimpleDemo : _ZNK3icu6number23NumberFormatterSettingsINS0_24LocalizedNumberFormatterEE10toSkeletonER10UErrorCode
    0x1032febf4 - /private/var/containers/Bundle/Application/F89D0267-2709-444E-A12D-D8C5FD797B03/SimpleDemo.app/SimpleDemo : _ZNK3icu6number23NumberFormatterSettingsINS0_24LocalizedNumberFormatterEE10toSkeletonER10UErrorCode
    0x1dc878d48 - /usr/lib/system/libsystem_platform.dylib : <redacted>
    0x1bbd4ebe0 - /usr/lib/system/libsystem_kernel.dylib : <redacted>
    0x1bbd4ec10 - /usr/lib/system/libsystem_kernel.dylib : <redacted>
    0x1d3f19708 - /System/Library/PrivateFrameworks/TCC.framework/TCC : <redacted>
    0x1d3f143d0 - /System/Library/PrivateFrameworks/TCC.framework/TCC : <redacted>
    0x1d3f16e94 - /System/Library/PrivateFrameworks/TCC.framework/TCC : <redacted>
    0x1dc8bb354 - /usr/lib/system/libxpc.dylib : <redacted>
    0x1dc8af5d0 - /usr/lib/system/libxpc.dylib : <redacted>
    0x18113410c - /usr/lib/system/libdispatch.dylib : <redacted>
    0x1810ed840 - /usr/lib/system/libdispatch.dylib : <redacted>
    0x1810e4878 - /usr/lib/system/libdispatch.dylib : <redacted>
    0x1dc884e48 - /usr/lib/system/libsystem_pthread.dylib : _pthread_wqthread
    0x1dc88493c - /usr/lib/system/libsystem_pthread.dylib : start_wqthread

=================================================================
    Basic Fault Address Reporting
=================================================================
Memory around native instruction pointer (0x1bbd4c64c):0x1bbd4c63c  c0 03 5f d6 c0 03 5f d6 30 41 80 d2 01 10 00 d4  .._..._.0A......
0x1bbd4c64c  e3 00 00 54 fd 7b bf a9 fd 03 00 91 ed 5b ff 97  ...T.{.......[..
0x1bbd4c65c  bf 03 00 91 fd 7b c1 a8 c0 03 5f d6 c0 03 5f d6  .....{...._..._.
0x1bbd4c66c  90 32 80 d2 01 10 00 d4 e3 00 00 54 fd 7b bf a9  .2.........T.{..

排查步骤

解析混淆的C++符号：堆栈里的_ZNK3icu6number23NumberFormatterSettingsINS0_24LocalizedNumberFormatterEE10toSkeletonER10UErrorCode是C++混淆名称，用c++filt工具可还原为icu::number::NumberFormatterSettings<icu::number::LocalizedNumberFormatter>::toSkeleton(UErrorCode&)，说明崩溃和ICU数字格式化逻辑相关，先排查绑定库或MAUI代码中调用数字格式化的部分。
检查iOS权限配置：堆栈出现TCC.framework（iOS权限控制框架），可能是应用请求了未声明的权限。检查项目的Info.plist，确认所有用到的权限（如相机、相册、位置等）都添加了对应的描述字段，iOS对权限的要求比Android严格。
获取符号化的完整崩溃日志：
- 在Xcode的「Window > Devices and Simulators」中找到测试设备，查看设备日志，定位对应崩溃报告后右键选择「Re-Symbolicate Crash Report」，生成包含.NET和原生代码详细调用栈的日志。
- 确保MAUI iOS项目的调试符号已启用：在项目属性中设置「Debug Information Format」为「Full」，勾选「Generate Debug Symbols」。
隔离绑定库代码定位问题：
- 创建最小化的MAUI iOS测试项目，仅调用绑定库的基础功能，逐步添加代码，排查是哪部分逻辑触发崩溃。
- 对比原Xamarin iOS绑定库代码，检查迁移至.NET 6时的API变更：比如原生方法签名、回调处理、内存管理（如[Preserve]属性使用、手动内存释放逻辑）是否正确。
排查ICU依赖冲突：
- .NET 6 for iOS对ICU的依赖和Xamarin iOS存在差异，检查绑定库是否依赖特定版本的ICU，或是否存在ICU库冲突。
- 尝试调整iOS项目的链接行为：在项目属性中设置「Linker Behavior」为「Don't Link」或「Link Framework SDKs Only」测试，排除链接器误删必要代码的可能。
调试原生代码：
- 若绑定库有对应的原生代码，将原生项目与MAUI项目关联，用Xcode设置断点在ICU相关方法上，跟踪崩溃时的参数和状态。
- 使用LLDB调试：终端运行lldb -- ./SimpleDemo.app/SimpleDemo，加载应用后设置断点，触发崩溃时查看寄存器和内存状态。
排查线程安全问题：堆栈显示崩溃发生在后台线程_pthread_wqthread，可能是多线程访问共享资源导致竞争条件。检查绑定库中是否有线程不安全的代码，或.NET代码调用原生方法时的线程上下文是否正确（比如是否在非UI线程调用了UI相关方法）。

内容的提问来源于stack exchange，提问作者guillaume-tgl