Komga阅读列表排序异常问题分析与修复

问题背景

在Komga漫画管理系统的1.50.0版本中，用户报告了一个关于阅读列表排序的严重问题。当用户导入包含特定结构的CBL格式阅读列表时，系统会错误地显示项目顺序，导致阅读体验受到严重影响。

问题现象

用户反馈的主要症状表现为：

1. 导入的阅读列表在UI界面和OPDS订阅源中显示顺序错误
2. 错误顺序呈现一致性，每次加载都保持相同的错误顺序
3. 原始CBL文件中的顺序是正确的，且导入过程中的匹配阶段也显示正确顺序
4. 问题仅出现在某些特定列表中，并非所有列表都受影响

技术分析

经过深入调查，开发团队发现该问题的根源在于数据库查询逻辑的缺陷。具体表现为：

1. 多阅读列表关联问题：当同一本漫画存在于多个阅读列表时，系统错误地从其他阅读列表中获取了排序序号，而非当前查看的列表。

2. 查询条件缺失：负责渲染UI界面的SQL查询没有正确限定当前阅读列表的上下文，导致跨列表获取了排序信息。

3. 版本回溯验证：用户测试发现1.41.1版本工作正常，而1.50.0版本出现问题，这帮助缩小了问题范围。

解决方案

开发团队针对此问题实施了以下修复措施：

1. 完善查询条件：确保所有涉及阅读列表项目的查询都严格限定在当前阅读列表范围内。

2. 增加数据隔离：防止不同阅读列表之间的排序信息相互干扰。

3. 优化关联查询：重新设计了表关联逻辑，确保在多表连接时能正确获取当前上下文的排序信息。

影响与启示

该问题的修复不仅解决了特定情况下的排序错误，还提升了整个系统的数据一致性。对于开发者而言，这个案例提醒我们：

1. 在多对多关系的数据模型中，必须特别注意查询条件的精确性。

2. 版本升级时的回归测试需要覆盖各种边界条件。

3. 用户提供的详细复现步骤和版本对比信息对问题定位至关重要。

该修复已包含在Komga 1.16.0版本中发布，用户升级后即可解决阅读列表排序错误的问题。