Flagsmith项目中定时变更请求重复显示问题的技术分析

问题背景

在Flagsmith项目中，当版本控制功能启用时，用户创建并发布定时变更请求后，系统会在"Scheduling"选项卡中显示重复的条目。这个问题影响了用户体验，可能导致管理员对变更状态产生混淆。

问题重现步骤

1. 在启用版本控制的环境中创建未来执行的变更请求
2. 在"变更请求"选项卡中确认只有一个变更请求存在
3. 发布该变更请求
4. 在"调度"选项卡中观察到两个完全相同的待处理变更

技术原因分析

经过深入调查，发现问题的根本原因在于系统生成了两个完全相同的变更集(change_sets)：

1. 其中一个变更集被标记为已删除状态
2. 另一个变更集保持活动状态

这两个变更集的内容完全相同，导致底层SQL查询返回重复的行记录。

前端与后端的交互问题

通过检查网络请求日志，发现前端在创建变更请求时存在以下行为序列：

1. 首先发送POST请求创建变更
2. 紧接着发送PUT请求更新相同的变更

关键问题在于PUT请求的负载中：

• 没有包含版本变更集的ID信息
• 内容与POST请求完全相同

这种交互模式导致后端API执行了以下操作：

1. 删除不再包含在PUT请求中的变更集
2. 创建一个全新的变更集

解决方案方向

后端改进

虽然API当前的行为从技术角度是正确的（按照接收到的指令执行），但仍需优化以避免返回重复记录。具体改进方向包括：

1. 修改查询逻辑，过滤掉已删除的变更集
2. 实现更智能的变更集合并逻辑，避免创建重复项

前端改进

前端应立即修复以下问题：

1. 避免在创建变更后立即发送冗余的PUT请求
2. 确保PUT请求负载包含必要的版本控制信息
3. 优化变更请求的状态管理逻辑

总结

这个问题展示了前后端交互中常见的状态同步挑战。在版本控制系统中，变更的生命周期管理需要特别谨慎。Flagsmith团队需要协同前后端开发人员，确保变更请求的创建、更新流程符合预期，同时提供一致的用户体验。

对于开发者而言，这个案例也提醒我们：在实现版本控制功能时，需要特别注意变更集的创建和更新逻辑，避免产生重复或冲突的记录。