仪表板/数据大屏自动刷新需同时满足前端开关开启和后端数据集支持实时拉取，缺一不可；右上角“更多→自动刷新”仅为前端控制，数据集须为实时数据集或勾选“支持实时卡片数据”的直连/universe数据集才能真正生效。
仪表板/数据大屏的自动刷新开关在哪？
自动刷新不是点一下就全局生效的功能，它分两层：前端页面开关 + 后端数据集支持。缺一不可。
- 在仪表板或数据大屏右上角点击“更多”，打开“自动刷新”开关——这是前端动作，只控制页面是否定时重载
- 但若数据集本身不支持实时拉取（比如是离线导入的 CSV 或缓存超长的直连数据集），即使开了开关，看到的仍是旧数据
- 只有勾选了“支持实时卡片数据”的直连数据集/universe 数据集，或本身就是实时数据集，才能真正拿到新值
常见错误现象：页面明明开了自动刷新，但图表数字半小时没变——大概率是数据集没配“支持实时卡片数据”，或者管理员在系统管理 → 实时设置里把最低刷新间隔设成了 5 分钟，而你期望秒级更新。
实时数据集 vs 直连数据集：刷新行为差异
两者都支持自动刷新，但底层机制和配置要求不同：
- 实时数据集：开前端
自动刷新即可，系统会走流式通道或长连接，延迟通常在秒级 - 直连数据集/universe 数据集：必须同时满足两个条件——前端开
自动刷新+ 数据集编辑页勾选支持实时卡片数据，否则仍走默认缓存（默认缓存有效时长决定最小刷新间隔）
性能影响很实在：直连数据集若计算复杂（比如多表关联+窗口函数），每 10 秒刷一次可能直接拖慢整个看板响应；而实时数据集虽快，但若后端未做变更订阅或消息队列削峰，高并发下容易触发timeout或502 Bad Gateway。
刷新频率怎么调？别只看前端开关
页面右上角的“自动刷新”只是启用开关，真正控制多久刷一次的，是管理员配置项：
- 进入
管理员设置 → 系统管理 → 实时设置 - 仪表板刷新频率最低 1 分钟起步，且不能短于直连数据集的
默认缓存有效时长 - 数据大屏可设到 1 秒，但要注意：1 秒轮询对后端 QPS 压力极大，不建议在未压测前提下直接启用
使用场景提示：
- 销售大屏盯实时成交额？设 5–10 秒较稳妥
- 资源监控面板查 CPU 使用率？1–3 秒合理，前提是指标已预聚合、无 JOIN
- 普通经营分析报表？30 秒–5 分钟更平衡体验与负载
为什么开了自动刷新，数据还是滞后？排查路径
这不是 bug，而是链路中某环断了。按顺序快速验证：
- 检查当前卡片绑定的数据集类型：是
实时数据集？还是直连数据集？后者必须确认是否勾选支持实时卡片数据 - 查看该数据集的
缓存策略：如果缓存有效期设为 10 分钟，那即使前端设成 10 秒，实际最多每 10 分钟才从库拉一次新数据 - 看网络请求：用浏览器 DevTools 的 Network 面板过滤
/api/v1/dataset/query类请求，观察响应头是否有X-Cache: HIT，以及响应时间是否稳定 - 注意权限隔离：某些平台对非管理员用户会强制降频，即使配置写了 10 秒，实际生效可能是 60 秒
最常被忽略的一点：自动刷新只刷新「已加载的图表」，如果你用了 Tab 切换或懒加载组件，切到新 Tab 的那一刻并不会自动触发刷新，得手动点一次或等下次定时周期到来。
