Zulip项目中频道订阅者计数异常问题分析

问题背景

在Zulip即时通讯系统中，当用户取消订阅某个频道后，右侧边栏显示的订阅者计数会出现异常情况。具体表现为：当频道中只有用户自己作为订阅者时，发送消息后取消订阅，系统错误地显示该频道拥有-1个订阅者，而非预期的0个订阅者。

技术原理

Zulip的右侧边栏会显示当前频道的订阅者数量，这个数值是通过计算当前频道的总订阅者数与所有参与讨论的用户数之差得出的。核心计算公式为：

订阅者计数 = 总人类订阅者数 - 所有参与者ID集合的大小

问题根源

当用户取消订阅后，系统未能正确处理以下特殊情况：

1. 用户取消订阅但频道中仍保留其历史消息
2. 计算逻辑没有考虑"已取消订阅但仍参与讨论"的用户场景
3. 在主题讨论(topic)存在时，计数逻辑存在缺陷

解决方案分析

针对此问题，技术团队提出了改进的计算方法：

1. 引入"已取消订阅但参与讨论的用户数"变量

2. 修正后的计算公式为：

   订阅者计数 = 总人类订阅者数 - 所有参与者ID集合的大小 + 已取消订阅但参与讨论的用户数
   

3. 具体实现步骤：

   • 遍历当前讨论中的所有参与者ID
   • 检查每个用户是否在当前频道中但未订阅
   • 统计符合条件的用户数量

技术实现细节

在代码层面，解决方案涉及以下关键修改：

1. 在buddy_list.ts文件中增加计数逻辑

2. 添加对当前订阅状态的检查：

   let unsubscribed_posters_count = 0;
   all_participant_ids.forEach((user_id) => {
       if (this.render_data.current_sub && !stream_data.is_user_subscribed(this.render_data.current_sub.stream_id, user_id)) {
           unsubscribed_posters_count++;
       }
   });
   

3. 整合新的计数变量到原有计算逻辑中

影响范围评估

该修复主要影响以下功能场景：

1. 用户取消订阅后的界面显示
2. 频道订阅者计数计算
3. 右侧边栏的用户数统计

总结

Zulip开发团队通过分析订阅者计数异常问题，找出了计算逻辑中的缺陷，并提出了基于实际订阅状态的修正方案。这一改进确保了系统在各种用户操作场景下都能正确显示订阅者数量，提升了用户体验和界面信息的准确性。