Tuist Cloud 仪表盘12个月过滤器失效问题分析与解决

问题背景

在Tuist Cloud项目的最新版本中，用户报告了一个关于仪表盘时间过滤功能的异常现象。当用户选择"12个月"作为时间过滤条件时，系统未能正确显示过去12个月的数据，而是仅显示了最近30多天的数据。这一异常行为发生在2025年新年伊始，影响了使用较新版本Chrome浏览器(131.0.6778.265+)和macOS 15.2系统的用户。

技术分析

经过开发团队调查，这个问题与Tuist Cloud仪表盘页面采用的LiveView导航技术有关。LiveView是一种实时视图更新技术，它允许在不完全刷新页面的情况下动态更新界面内容。在本案例中，当用户选择12个月过滤选项时，前端与后端的交互出现了预期之外的行为。

根本原因

问题的核心在于仪表盘首页迁移到LiveView导航架构时引入的一个已知问题。开发团队原本就意识到这种导航方式在特定场景下可能存在问题，但在后续开发过程中这个注意事项被遗漏了。具体表现为：

1. 时间范围参数在客户端与服务器端传递时出现了不一致
2. LiveView的实时更新机制未能正确处理12个月这种较长周期的过滤请求
3. 状态管理在导航过程中未能正确保留用户选择的时间范围

解决方案

开发团队迅速定位并修复了这个问题。修复方案主要包括：

1. 重新审视LiveView导航在首页的实现逻辑
2. 确保时间范围参数在前后端传递时的一致性
3. 优化状态管理机制，确保用户选择能够被正确应用

验证与反馈

修复部署后，用户确认问题已解决，12个月过滤功能恢复正常工作。这一快速响应体现了Tuist Cloud团队对用户体验的重视和对技术问题的敏锐洞察力。

经验总结

这个案例为开发者提供了几个重要启示：

1. 在引入新技术架构(如LiveView)时，需要全面考虑各种使用场景
2. 已知问题的文档记录和团队知识共享至关重要
3. 用户反馈是发现和解决问题的重要渠道
4. 快速响应和修复能够有效提升用户满意度

对于使用类似实时视图技术的开发者，建议在实现时间范围过滤等功能时，特别注意长周期参数的传递和处理，确保在各种边界条件下都能正常工作。