React Native Navigation 在三星设备上的UI线程崩溃问题分析

问题背景

在使用React Native Navigation库(版本7.40.0)与React Native(版本0.74.5)开发的应用中，部分三星设备(如Galaxy S24)在特定情况下会出现UI线程相关的崩溃问题。这个问题主要发生在应用消耗大量电量时，表现为应用在调用setRoot方法时崩溃。

错误现象

从错误日志中可以观察到两个关键错误：

1. com.facebook.react.bridge.AssertionException: Expected to run on UI thread! - 表明某些操作没有在UI线程上执行
2. android.view.ViewRootImpl$CalledFromWrongThreadException - 典型的Android UI线程违规错误，说明视图操作在非UI线程执行

根本原因分析

经过深入分析，问题出在NavigationActivity类的onConfigurationChanged方法实现上。当设备配置发生变化时(如屏幕旋转、主题切换等)，Android系统会调用此方法。在React Native Navigation的实现中，这个方法直接调用了React Native的相关配置更新方法，而没有确保这些操作在UI线程上执行。

技术细节

在Android系统中，所有与视图相关的操作都必须在UI线程(也称为主线程)上执行。React Native Navigation在处理配置变更时，需要与React Native的桥接层交互，而React Native的某些操作也严格要求在UI线程执行。

当设备配置发生变化时，系统回调可能发生在非UI线程，特别是在高负载情况下(如应用消耗大量电量时)，系统可能会选择在后台线程处理配置变更以提高性能。

解决方案

针对这个问题，开发者提供了一个有效的解决方案 - 通过runOnUiThread方法确保所有视图相关操作都在UI线程执行。修改后的onConfigurationChanged方法如下：

@Override
public void onConfigurationChanged(@NonNull Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    runOnUiThread(() -> {
        getReactGateway().onConfigurationChanged(this, newConfig);
        navigator.onConfigurationChanged(newConfig);
    });
}

这个修改确保了：

1. 配置变更的处理逻辑被包装在UI线程执行块中
2. 所有视图操作都符合Android的线程安全要求
3. 保持了原有功能的完整性

最佳实践建议

1. 线程安全原则：在Android开发中，任何涉及视图的操作都应默认在UI线程执行
2. 配置变更处理：对于可能影响UI的配置变更，建议总是使用runOnUiThread确保线程安全
3. 性能考量：虽然UI线程操作是必须的，但应注意不要在UI线程执行耗时操作
4. 兼容性测试：不同厂商的Android设备可能有不同的线程调度策略，建议在各种设备上进行充分测试

总结

这个案例展示了Android开发中常见的线程安全问题，特别是在混合使用原生Android和React Native时。通过确保所有UI操作都在正确的线程上执行，可以有效避免类似的崩溃问题。对于React Native Navigation用户来说，这个解决方案简单有效，可以作为类似问题的参考处理方式。