使用CLI导出导入Superset仪表盘做版本控制出现TypeError如何解决

你的报错是导出逻辑遍历所有仪表盘时，遇到了json_metadata字段为NULL的脏数据仪表盘，JSON解析触发类型错误。该字段存储了仪表盘的布局、权限配置等核心元数据，空值会导致导出逻辑中断。

步骤1：定位异常仪表盘 #

首先进入运行中的Superset服务容器，执行命令启动Superset shell：

superset shell

在shell中执行以下Python代码，查询所有json_metadata为空的仪表盘：

from superset.models.dashboard import Dashboard
from sqlalchemy import func

null_dashboards = Dashboard.query.filter(
    Dashboard.json_metadata.is_(None)
).all() + Dashboard.query.filter(
    func.json_unquote(Dashboard.json_metadata) == 'null'
).all()

for dash in null_dashboards:
    print(f"仪表盘ID：{dash.id}，仪表盘名称：{dash.dashboard_title}")

步骤2：修复脏数据 #

可根据实际需求选择以下任意一种处理方式：

• 如果异常仪表盘是废弃资源，直接在前端删除即可
• 如果需要保留该仪表盘，可在前端打开编辑页面，直接点击保存，系统会自动补全合法的json_metadata值
• 如果不想修改仪表盘配置，可直接在shell中执行以下代码批量补全默认值：

from superset.extensions import db

for dash in null_dashboards:
    if not dash.json_metadata or dash.json_metadata.strip() == 'null':
        dash.json_metadata = '{}'
        db.session.add(dash)
db.session.commit()

步骤3：重新执行导出 #

脏数据修复完成后，再次执行导出命令即可正常导出所有仪表盘：

superset export-dashboards -f /tmp/superset_dashboards_backup.zip

导出完成后可执行docker cp <容器ID>:/tmp/superset_dashboards_backup.zip <宿主机本地路径>把备份包复制到宿主机持久化存储，导出的压缩包可直接用于同版本或更高版本Superset的仪表盘导入。

内容的提问来源于stack exchange，提问作者Ali Hussain Mir