Altair无法读取本地JSON数据，图表无内容求排查方向

我用Polars对Dataframe做逆透视操作，转换为Pandas Dataframe后使用Altair绘图。因数据集较大，按照Altair官方文档方法配置数据转换器，将数据保存至本地JSON文件，但生成的Altair图表仅显示坐标轴和画布，无数据内容；绘制boxplot时也出现同样的空图表情况，怀疑Altair读取本地JSON数据存在问题，以下是具体排查方向：

排查方向 #

• 检查JSON文件路径与访问权限
  • 确保data_dir使用绝对路径，相对路径可能导致前端渲染时无法定位到文件；
  • 确认JSON文件已成功生成，打开文件查看是否包含完整的数据集内容；
  • 检查运行环境（如Jupyter）对该文件路径是否有读取权限，避免权限不足导致加载失败。
• 验证数据转换器实现
  • 在json_dir函数中，打印生成的JSON文件路径，确认路径格式正确（避免出现拼接错误，比如缺少分隔符）；
  • 暂时替换为Altair内置的json转换器测试：alt.data_transformers.enable('json')，若能正常显示图表，说明自定义转换器存在问题。
• 检查数据格式兼容性
  • 验证Polars转Pandas后的Dataframe：用df.info()确认字段类型（比如数值列是否被转为字符串），用df.head()查看数据是否有异常空值或格式错误；
  • Boxplot为空时，确认用于编码的字段是数值类型，且分组字段有有效数据（避免因分组后无数据导致图表为空）。
• 环境与渲染方式排查
  • 若在Jupyter环境，尝试切换渲染器：alt.renderers.enable('jupyterlab')或alt.renderers.enable('mimetype')；
  • 检查Altair版本，建议升级到最新稳定版，避免版本bug导致的数据加载问题。

附示例代码 #

import os
import pandas as pd
import altair as alt
from toolz.curried import pipe

def json_dir(data, data_dir='/path/to/altairdata'):
    os.makedirs(data_dir, exist_ok=True)
    return pipe(data, alt.to_json(filename=data_dir + '/{prefix}-{hash}.{extension}') )

alt.data_transformers.register('json_dir', json_dir)
alt.data_transformers.enable('json_dir')
alt.data_transformers.disable_max_rows()

alt.Chart(pd.DataFrame({'A': [1,2,3], 'B': [5,8,10]})).mark_point().encode(x='A', y='B')

内容的提问来源于stack exchange，提问作者csmittie