Snap Hutao项目中黑缨枪养成计划闪退问题的技术分析

问题背景

在Snap Hutao项目的1.12.1版本中，用户反馈在武器界面选择黑缨枪添加养成计划时出现闪退问题。具体表现为当用户尝试将黑缨枪从20级升至90级时，无论选择覆盖、跳过还是创建新计划，点击确定后程序都会立即崩溃。

技术原因分析

通过分析错误日志，我们发现问题的根本原因在于JSON序列化过程中对ImmutableArray的默认实例进行了操作。具体错误信息显示：

System.InvalidOperationException: This operation cannot be performed on a default instance of ImmutableArray<T>.

这个异常发生在尝试序列化一个未初始化的ImmutableArray时。在.NET中，ImmutableArray有一个特殊的默认值（通过default(ImmutableArray)获得），它不是null，但也不能执行常规集合操作。

问题定位

深入分析调用栈后，我们发现错误发生在以下流程中：

1. 用户在界面操作触发WikiWeaponViewModel.CultivateAsync方法
2. 调用CalculateClient.BatchComputeAsync方法准备计算数据
3. 在JSON序列化步骤中，尝试序列化包含ImmutableArray的数据结构
4. 由于ImmutableArray未被正确初始化，导致序列化失败

解决方案

开发团队在提交3007779中修复了这个问题。修复的核心思路是：

1. 确保所有ImmutableArray在使用前都被正确初始化
2. 在序列化前添加对ImmutableArray.IsDefault的检查
3. 对于可能包含ImmutableArray的数据结构，提供默认值处理逻辑

技术启示

这个问题给我们几个重要的技术启示：

1. ImmutableArray的特殊性：与常规集合不同，ImmutableArray有特殊的默认状态，开发时需要特别注意初始化问题。

2. 防御性编程：在序列化/反序列化场景中，应该对输入数据进行更严格的验证，特别是对于特殊数据结构。

3. 错误处理：对于可能抛出异常的序列化操作，应该提供更友好的错误处理和恢复机制。

4. 测试覆盖：需要增加对边界条件的测试，特别是数据结构默认状态的测试用例。

影响范围

该问题主要影响：

1. 使用ImmutableArray作为数据模型属性的场景
2. 涉及武器养成计划计算的功能模块
3. 所有依赖JSON序列化/反序列化的相关功能

最佳实践建议

基于这个问题的经验，我们建议：

1. 在使用ImmutableArray时，始终检查IsDefault属性
2. 为不可变集合提供明确的初始化逻辑
3. 在序列化框架中增加对特殊数据结构的支持
4. 在单元测试中覆盖默认值场景

这个问题在1.12.2版本中得到了彻底解决，用户现在可以正常使用黑缨枪的养成计划功能。