React Native Maps 在 New Architecture 模式下的启动崩溃问题分析

问题背景

React Native 0.74 版本引入了全新的 Bridgeless New Architecture 模式，这一架构变革旨在提升性能并简化 React Native 的运行机制。然而，在使用 react-native-maps 库时，开发者遇到了应用启动崩溃的问题，表现为错误信息："(NOBRIDGE) ERROR Error: Exception in HostFunction: " 和 Xcode 中的 "SurfaceRegistryBinding::startSurface failed. Global was not installed."。

问题根源

经过深入分析，发现问题主要出现在 Google Maps 的 iOS 实现部分。具体来说，当在 Podfile 中添加以下配置时会导致崩溃：

rn_maps_path = '../node_modules/react-native-maps'
pod 'react-native-google-maps', :path => rn_maps_path

而使用 Apple Maps 作为 provider 时则工作正常，这表明问题特定于 Google Maps 的实现。

技术分析

线程安全问题

核心崩溃原因在于 [GMSService openSourceLicenseInfo] 方法的调用。在 Bridgeless 模式下，这个方法被从后台线程调用，而 Google Maps SDK 要求必须在主线程执行。这导致了以下异常：

[AIRGoogleMapManager constantsToExport] threw and exception: The API method must be called from the main thread

解决方案探索

1. 临时解决方案：将 [GMSServices openSourceLicenseInfo] 替换为空字符串可以避免崩溃，但这显然不是理想的长期方案。

2. 正确修复方案：需要确保相关代码在主线程执行。React Native 团队需要在框架层面解决这个问题，确保在 Bridgeless 模式下正确管理线程调用。

影响范围

这个问题不仅限于 react-native-maps，其他库如 react-native-mmkv 也报告了类似问题，表明这是 New Architecture 模式下更广泛的线程管理挑战。

最佳实践建议

对于开发者遇到此问题，可以采取以下步骤：

1. 暂时使用 Apple Maps 作为替代方案
2. 等待 React Native 框架层面的修复
3. 关注 react-native-maps 的更新，查看是否有针对 New Architecture 的专门修复

未来展望

随着 React Native 新架构的成熟，预计这类线程管理问题将得到系统性的解决。开发者社区和核心团队正在积极协作，以确保第三方库能够平滑过渡到新架构。

这个问题凸显了架构迁移过程中可能遇到的兼容性挑战，也提醒库开发者需要特别注意线程安全性和主线程要求的 API 调用。