Neko项目中的MangaDex搜索过滤器崩溃问题分析

问题现象

在Neko漫画阅读器应用中，当用户尝试在浏览标签页点击搜索按钮时，应用程序会发生崩溃。这个问题主要出现在2.18.2版本中，运行在Android 10系统的Xiaomi Mi8设备上。

崩溃原因分析

根据错误日志显示，崩溃的根本原因是序列化异常。具体错误信息表明：

kotlinx.serialization.SerializationException: eu.kanade.tachiyomi.source.online.utils.MdLang does not contain element with name 'LINTHUANIAN' at path $.originalLanguage[29].language

这是一个明显的拼写错误导致的异常。系统在尝试解析MangaDex语言过滤器时，遇到了一个名为"LINTHUANIAN"的语言项，而正确的拼写应该是"LITHUANIAN"(某欧洲国家语言)。

技术细节

1. 序列化过程：应用在加载搜索过滤器时，使用了kotlinx.serialization库来处理JSON数据
2. 枚举验证：系统在反序列化过程中会验证枚举值是否有效
3. 数据持久化：搜索过滤器的设置被保存在应用的持久化存储中

解决方案

这个问题可以通过以下两种方式解决：

1. 清除搜索过滤器：在MangaDex设置中清除现有的搜索过滤器设置
2. 代码修复：开发者需要修正语言枚举中的拼写错误，确保"LITHUANIAN"拼写正确

预防措施

1. 输入验证：在序列化/反序列化过程中增加严格的输入验证
2. 枚举处理：为枚举类型实现更健壮的错误处理机制
3. 数据迁移：对于已保存的错误数据，实现自动修正机制

影响范围

这个问题主要影响：

• 使用MangaDex作为源的Neko用户
• 尝试使用语言过滤功能的用户
• 设备上保存了错误过滤设置的用户

总结

这类问题展示了在开发过程中严格验证数据的重要性，特别是当涉及到枚举类型和持久化存储时。开发者需要确保：

1. 枚举值的命名一致性
2. 向后兼容的数据处理
3. 完善的错误处理机制

对于终端用户来说，最简单的解决方案是清除现有的搜索过滤器设置，等待应用更新修复这个拼写错误问题。