Apache Superset嵌入Angular时出现'metrics' KeyError问题求助

问题核心 #

从日志堆栈能定位到，错误触发点在security/manager.py第1954行：stored_chart.params_dict["metrics"]抛出了KeyError。原因是部分旧图表的配置参数用的是单数metric，但嵌入API调用时，后端校验逻辑默认只读取复数metrics字段——Superset门户内部有兼容处理，但嵌入场景的校验逻辑没覆盖到这个参数差异。

解决思路 #

1. 批量修正数据库中的旧图表参数 #

直接修改Superset存储图表配置的数据库表，把单数metric字段统一替换为复数metrics：

• 找到存储图表的核心表（通常是slice表，不同版本可能略有差异）
• 执行SQL更新语句：

UPDATE slice
SET params = JSON_SET(params, '$.metrics', JSON_EXTRACT(params, '$.metric'))
WHERE JSON_CONTAINS_PATH(params, 'one', '$.metric');

执行完成后清理Superset缓存，重启后端服务。

2. 修改后端校验逻辑做兼容 #

如果不想改动数据库，可直接修改security/manager.py中的校验代码，增加对metric字段的 fallback 处理：
找到报错的代码行：

or form_data.get("metrics", []) != stored_chart.params_dict["metrics"]

修改为：

or form_data.get("metrics", []) != stored_chart.params_dict.get("metrics", stored_chart.params_dict.get("metric", []))

修改后重启Superset服务，让校验逻辑自动适配单复数参数。

3. Angular端拦截请求做参数转换 #

在Angular侧通过请求拦截器，统一处理调用Superset API的参数：

• 拦截图表数据请求，检查请求体中的form_data，如果存在metric字段，将其转换为metrics数组（因为旧图表的metric通常是单个值，转数组匹配后端要求）
• 示例拦截器代码片段：

intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {
  if (req.url.includes('/api/v1/chart/data')) {
    const body = { ...req.body };
    if (body?.form_data?.metric) {
      body.form_data.metrics = [body.form_data.metric];
      delete body.form_data.metric;
    }
    const modifiedReq = req.clone({ body });
    return next.handle(modifiedReq);
  }
  return next.handle(req);
}

4. 升级Superset到稳定新版本 #

这个参数兼容问题大概率是旧版本的遗留bug，升级到3.x及以上的稳定版，官方可能已经修复了单复数参数的统一处理逻辑，无需手动修改代码或数据库。

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