数据与可视化问题

数据和可视化问题通常要沿着链路排查：数据源 → 数据集 → 图表 → 仪表盘 / 大屏 → 分享 / 导出。除最终页面状态外，还要确认上游数据是否可用。

数据源连接失败

先从数据源列表确认是否选中了正确的数据源和目录。正式环境中常有测试库、预发库、生产库多个连接，名称相近时容易选错对象。打开详情后再测试连接和预览表数据。

数据集预览为空

数据集预览为空不一定是系统故障。优先确认数据源表是否有数据，再检查数据集是否设置了过滤、SQL、分组、计算字段、行权限或缓存。截图中的数据集配置入口用于确认字段来源和处理逻辑。

排查顺序：

1. 数据源连接是否成功。
2. 表或 SQL 是否有数据。
3. 过滤条件是否过严。
4. 行权限是否限制了当前用户。
5. 字段类型是否识别正确。
6. 缓存是否过期或同步失败。

图表为空或指标不正确

图表问题要回到编辑器检查字段配置。截图中的编辑器可以同时检查数据集、维度、指标、筛选、样式和预览结果。仅查看最终仪表盘页面无法确认字段拖放和聚合方式。

常见原因：

• 维度和指标放置不正确。
• 聚合方式不符合业务口径。
• 日期字段格式不正确。
• 过滤条件、联动条件或钻取条件生效。
• 当前用户没有数据权限。
• 数据集字段被删除或重命名。

处理建议：

1. 回到数据集预览确认原始数据。
2. 临时移除图表过滤条件。
3. 检查维度、指标和聚合方式。
4. 使用管理员账号和普通账号分别验证。
5. 查看数据血缘，确认字段来源。

仪表盘打开慢

先确认是所有仪表盘都慢，还是某一个仪表盘慢。如果只有某一个慢，通常和图表数量、SQL、字段聚合、筛选器默认值或大图片有关；如果所有仪表盘都慢，再看服务资源、数据库连接和网络。

可能原因：

大屏预览样式异常

样式问题先在编辑器中确认组件位置、画布尺寸、图层顺序和字体。大屏是固定画布，浏览器缩放、投屏分辨率、字体缺失和图片丢失都会影响最终效果。

处理顺序：

1. 检查浏览器缩放比例。
2. 检查画布尺寸和适配方式。
3. 检查上传图片是否丢失。
4. 检查字体是否在当前环境存在。
5. 检查预览页和编辑器是否同样异常。
6. 对外展示前用目标屏幕分辨率验证。

预览页用于模拟观众看到的效果。上线前除检查编辑器外，必须打开预览页检查全屏比例、图表刷新、标题层级、背景图片、字体和边缘留白。

导出失败

导出中心用于判断任务是否真正执行。用户反馈导出失败时，先检查任务是否生成、状态是否失败、失败是否集中在某类资源，再排查应用日志和文件目录权限。

先在导出中心查看任务状态，再看应用日志。

大屏导出按钮不可用

v1.5.5 起，数据大屏支持通过导出按钮绑定表格视图并提交 Excel 导出任务。按钮不可用时，按以下顺序排查：

1. 导出按钮是否已经绑定目标表格。
2. 目标表格是否有数据。
3. 当前账号是否有导出权限。
4. 导出范围是否选择了当前筛选结果或全部数据。
5. 页面查询组件、联动、外部参数是否导致结果为空。
6. 导出中心是否生成任务，任务是否失败。

如果导出任务被取消或后端返回错误，v1.5.6 会给出更明确的失败反馈。仍无法定位时，保留导出时间、资源名称、筛选条件和导出中心状态，交给管理员查看应用日志。

明细表合并效果不符合预期

v1.5.6 起，明细表可以在开启“合并单元格”后选择合并字段。合并只针对上下相邻且值相同的单元格；选择后置维度时，会在前置维度相同的范围内合并。

常见问题：

如何确认字段来源

入口：数据血缘。

数据血缘适合回答：

• 某个图表字段来自哪个数据集字段。
• 数据集字段来自哪个数据源表字段。
• 修改某个数据源字段会影响哪些图表。
• 删除数据集前会影响哪些仪表盘或大屏。

排查字段问题时，建议先查看血缘，再决定是否修改数据源、数据集或图表。

排查时不要忽略缓存

v1.5.7 起，MySQL 数据源数据集支持缓存读取。数据集开启缓存后，图表读取的可能不是数据源实时结果。遇到“数据库里已经更新，但页面还是旧数据”的问题，按以下顺序确认：

1. 打开数据集，查看是否启用了缓存。
2. 查看缓存同步时间和同步状态。
3. 查看源数据行数、缓存行数和一致性校验结果。
4. 手动触发一次同步或等待定时任务执行。
5. 回到图表、仪表盘或数据大屏刷新页面。
6. 如果仍是旧数据，再检查 SQL、过滤条件、增量字段和数据权限。

缓存适合提升查询性能，但需要和业务方说明刷新周期。实时监控类页面不建议使用过长缓存周期。

常见状态处理：