React Native Screens 项目中 iOS 旧架构下的模态框导航问题解析

问题背景

在 React Native Screens 项目中，iOS 平台使用旧架构（Paper）时，开发者报告了一个关于模态框导航的异常行为。当导航栈中存在两个卡片式模态框时，调用 navigation.goBack() 方法会导致意外地弹出两个屏幕，而不是预期的单个屏幕回退。

问题表现

具体表现为：

1. 打开第一个模态框（屏幕"One"）
2. 从第一个模态框中打开第二个模态框（屏幕"Two"）
3. 在第二个模态框中点击返回按钮
4. 预期行为是返回到第一个模态框（屏幕"One"）
5. 实际行为是直接返回到根页面，跳过了第一个模态框

技术分析

经过深入分析，发现问题出在 ScreenStack.onDismissed 方法的错误调用上。在旧架构中，当执行返回操作时，该方法会被错误地触发，导致系统额外发送了一个 POP 动作，从而造成了双重返回效果。

值得注意的是，这个问题在新架构（Fabric）中并不存在，只在旧架构中出现，这表明问题与 React Native 底层架构处理导航事件的方式有关。

解决方案

项目维护团队确认了这个问题，并提出了修复方案。核心思路是修正 ScreenStack.onDismissed 方法的触发逻辑，确保它只在真正需要时被调用，而不会在正常的返回操作中被错误触发。

修复方案已经通过 pull request 提交，并在 4.4.0-rc.1 版本中发布。开发者可以通过升级到该版本或后续的稳定版本来解决这个问题。

临时解决方案

在官方修复发布前，开发者可以采用以下临时解决方案：

1. 降级 react-native-screens 到 3.35.0 版本
2. 配合使用 @react-navigation/native-stack 6.6.1 版本
3. 对于简单场景，可以考虑使用 @react-navigation/stack 替代 native-stack

最佳实践建议

为了避免类似问题，建议开发者：

1. 尽可能升级到新架构（Fabric），它不仅解决了这个问题，还带来了更好的性能和更多功能
2. 保持依赖库的最新版本，及时应用修复
3. 在复杂导航场景中，充分测试各种导航路径
4. 考虑使用导航状态日志工具来监控导航行为

总结

React Native Screens 项目团队快速响应并修复了这个 iOS 旧架构下的导航问题，体现了开源社区的高效协作。对于仍在使用旧架构的开发者，建议尽快升级到包含修复的版本，以获得更稳定可靠的导航体验。同时，这也提醒我们，在跨平台开发中，不同架构可能会表现出不同的行为，充分的测试覆盖是保证应用质量的关键。