Expensify/App Android端测试驾驶功能加载问题分析与解决方案

问题背景

在Expensify移动应用的Android版本中，用户在进行测试驾驶流程时遇到了一个关键性问题。当用户完成邮箱输入并点击"开始测试驾驶"按钮后，界面会陷入无限加载状态，无法正常进入后续的测试收据提交环节。这个问题在Android 14系统的三星Galaxy Z Fold 4设备上被首次发现并报告。

问题现象

用户操作路径如下：

1. 启动Expensify应用
2. 使用新Gmail账户登录
3. 跳过工作邮箱页面
4. 选择"跟踪和预算支出"功能
5. 输入姓名并继续
6. 在"带我们进行测试驾驶"模态框中输入邮箱
7. 点击开始测试驾驶按钮

预期行为是应用应进入确认页面，向用户提交测试收据。但实际观察到的却是按钮持续加载，无法完成流程。

技术分析

经过开发团队深入排查，发现问题根源在于Android原生环境下处理静态资源的方式存在差异。具体表现为：

1. 在调试模式下，resolveAssetSource方法能够正确返回形如http://localhost:8081/xxxx的URI，使得文件下载流程可以正常进行。

2. 但在发布模式下，resolveAssetSource仅返回静态资源名称(如asset_1234)，而非有效的URI地址。这导致react-native-blob-util无法正确下载文件。

日志分析显示以下关键错误信息：

• java.net.MalformedURLException: no protocol - 表明URL格式不正确
• url == null - 表明请求构建时缺少有效URL
• 客户端日志显示"Error reading test receipt" - 确认收据读取失败

解决方案

针对这一问题，开发团队提出了基于expo-file-system和expo-asset的替代方案：

1. 使用expo-asset的Asset.loadAsync方法加载资源，该方法能正确处理Android环境下的静态资源。

2. 通过expo-file-system的copyAsync方法将资源复制到本地文件系统，确保在调试和发布模式下都能正常工作。

核心代码修改包括：

• 替换原有的resolveAssetSource和react-native-blob-util组合
• 实现新的文件处理逻辑，正确处理本地URI
• 添加完善的错误处理机制

兼容性考虑

值得注意的是，此问题不仅影响测试驾驶功能，也影响了McManager流程中的工具提示功能。经过版本回溯测试，发现该问题实际上自McManager测试功能发布(版本9.1.14-5)以来就一直存在。

解决方案特意针对Android平台进行了优化，同时保持iOS等其他平台的现有实现不变，确保不会引入新的兼容性问题。

总结

这个案例展示了React Native在跨平台开发中可能遇到的特定平台问题。通过深入分析Android资源加载机制，开发团队找到了既解决当前问题又保持代码简洁性的方案。这也提醒开发者在处理平台特定功能时，需要充分考虑不同构建模式下的行为差异。

该修复已随版本9.1.52-0部署到生产环境，经过7天回归测试后确认稳定，最终在版本9.1.53-7中完全解决。