Umami 分析平台中的城市筛选器自动补全问题解析

问题背景

在Umami网站分析平台的最新版本(v2.11.0)中，用户报告了一个关于报告创建功能的缺陷。具体表现为：当用户尝试在报告中添加基于城市、地区或来源等字段的筛选条件时，自动补全功能无法显示完整的历史数据选项，仅显示最近访问记录中的少数选项。

技术现象

从用户提供的截图和动画演示中可以观察到以下现象：

1. 在创建新报告时，城市筛选器的自动补全下拉菜单仅显示"Krasnodar"这一个选项
2. 该问题不仅限于城市字段，同样影响地区(region)和来源(referrer)等其他字段
3. 即使用户确认数据库中确实存在更多历史数据，界面也无法显示完整的选项列表

根本原因分析

经过技术团队深入调查，发现问题根源在于：

日期参数传递错误 - 当用户创建筛选条件时，系统错误地将查询范围限制在了最近一天的数据，而非默认的90天范围。这导致自动补全功能只能检索到最近24小时内出现的城市名称，而忽略了历史数据中存在的其他选项。

解决方案

开发团队已提交修复代码，主要修改点包括：

1. 修正了筛选条件查询时的日期范围参数传递逻辑
2. 确保自动补全功能始终使用与报告相同的日期范围进行数据检索
3. 优化了前后端数据交互流程，防止参数在传递过程中丢失或被覆盖

用户临时解决方案

在等待新版本发布期间，用户可以尝试以下临时解决方法：

1. 关闭当前筛选条件并重新打开
2. 手动输入已知的城市名称而非依赖自动补全
3. 适当扩大报告的时间范围以包含更多数据

技术启示

这个案例提醒我们，在开发数据分析类应用时，需要特别注意：

• 前后端参数传递的一致性验证
• 默认时间范围与实际查询范围的同步
• 自动补全功能的检索范围应当与用户预期保持一致

Umami团队将持续优化这类交互细节，提升用户体验和数据准确性。