Expensify/App 中扫描收据金额校验异常的分析与解决

问题背景

在Expensify/App的9.1.54-0版本中，用户在使用扫描收据功能时遇到了一个金额校验异常。具体表现为：当用户扫描收据后尝试拆分费用时，系统错误地显示"金额比扫描收据金额大2,608.33%"的警告信息，而实际上拆分后的金额并未超过原始扫描金额。

技术分析

这个问题的核心在于金额校验逻辑出现了异常。从技术角度来看，可能涉及以下几个关键点：

1. 金额计算逻辑：系统在拆分费用时，未能正确计算拆分后的各部分金额与原始扫描金额的关系。

2. 百分比计算错误：系统显示的2,608.33%这个异常高的百分比值表明，金额比较的计算公式可能存在问题，可能是分母设置错误或计算单位不一致。

3. 状态管理：在拆分操作过程中，可能没有正确维护和传递原始扫描金额的数据，导致校验时使用了错误的基础值。

4. 边界条件处理：系统可能没有充分考虑到各种拆分场景下的边界条件，特别是当拆分比例较小时的计算精度问题。

问题重现与验证

开发团队通过以下步骤重现了该问题：

1. 在工作区聊天中创建扫描费用
2. 完成扫描后尝试拆分费用
3. 保存拆分并查看费用报告

测试结果表明，在v9.1.54-0版本中该问题确实存在，但在后续版本(v9.1.54-2及更高版本)中，由于相关功能被回滚，问题不再出现。

解决方案

开发团队采取了以下措施解决该问题：

1. 功能回滚：首先回滚了引入该问题的相关代码变更，暂时移除了拆分功能，确保用户不会遇到错误的金额校验警告。

2. 根本原因分析：深入检查了金额校验逻辑的实现细节，特别是百分比计算部分，确保计算基于正确的基准值。

3. 全面测试：在修复后进行了全面的回归测试，验证各种拆分场景下的金额计算准确性。

经验总结

这个案例为我们提供了几个重要的经验教训：

1. 金额计算的严谨性：涉及金融计算的功能必须格外谨慎，任何小的计算错误都可能导致严重的用户体验问题。

2. 测试覆盖的重要性：需要针对各种可能的拆分比例进行充分测试，特别是边界条件。

3. 渐进式发布策略：对于涉及核心财务功能的变更，采用渐进式发布和密切监控可以及早发现问题。

4. 错误信息的友好性：系统错误信息应该清晰准确，避免显示令人困惑的百分比数值。

通过这次问题的解决，Expensify/App的金额校验机制得到了进一步完善，为后续类似功能的开发提供了宝贵经验。