Lottie-android 中 JSON 解析异常问题分析与解决方案

问题背景

在使用 Lottie-android 库渲染动画时，开发者遇到了一个 JSON 解析异常问题。具体表现为当解析包含小数值的 JSON 文件时，系统会抛出 IllegalStateException 异常，提示"Unable to parse composition"。这个问题主要出现在处理动画文件的宽度和高度属性时，当这些属性值包含小数部分时就会触发异常。

技术分析

异常根源

问题的核心在于 Lottie 的 JSON 解析器对数值类型的严格校验。在解析过程中，当遇到本应为整数的属性值（如宽度和高度）却包含小数部分时，解析器会抛出异常。例如，当 JSON 文件中出现类似"501.999"这样的高度值时，解析器期望这是一个整数，但实际得到的是浮点数，从而导致解析失败。

底层机制

Lottie-android 使用了一个高效的流式 JSON 解析器，在解析数值时必须预先指定类型是整数还是浮点数。这种设计原本是为了优化性能，减少内存分配。然而，当面对来自不同导出工具生成的 Lottie JSON 文件时，这种严格的类型检查就可能导致兼容性问题。

问题重现

1. 使用 LottieFiles 等在线工具创建动画
2. 导出 JSON 文件时，某些数值属性（特别是宽度和高度）可能包含小数部分
3. 在 Android 应用中加载这些文件时触发解析异常

解决方案

方案一：修改属性类型定义（推荐）

最合理的解决方案是将图层宽度和高度属性的解析类型从整数改为双精度浮点数。这种修改：

1. 保持了与各种导出工具的兼容性
2. 对渲染效果几乎没有影响（像素级差异肉眼不可见）
3. 不会引入明显的性能开销

方案二：数值强制转换

另一种思路是在解析过程中对特定属性进行强制类型转换，将浮点数值截断为整数。这种方法：

1. 适用于已知会出现问题的特定属性（如宽度和高度）
2. 保持了原有的整数类型定义
3. 需要为每个可能出问题的属性单独处理

实现建议

对于 Lottie 库维护者，建议采用第一种方案，即修改图层宽度和高度属性的解析逻辑，接受浮点数值。这种修改方向：

1. 更符合现代动画工具的实际输出
2. 解决了绝大多数同类问题
3. 保持了良好的向后兼容性

对于应用开发者，如果遇到类似问题，可以：

1. 检查 JSON 文件中是否有非整数数值
2. 考虑使用工具对文件进行预处理
3. 或者等待库的官方更新

总结

这个问题的出现反映了 Lottie 生态系统的发展：从最初仅支持 After Effects 导出，到现在支持多种创作工具。随着工具的多样化，JSON 文件的格式也出现了一些变化。Lottie 库需要适应这种变化，在保持核心功能的同时，提高对各种合法格式的兼容性。