求助：无法使用Jinja变量保存Superset数据集的问题排查

核心问题本质 #

SQL Lab能运行带模板变量的SQL，但数据集和图表层面报错，是因为这三个场景的模板变量处理逻辑完全不同：SQL Lab是临时手动传参执行，而数据集保存、图表渲染会做预校验和自动解析，仅开启ENABLE_TEMPLATE_PROCESSING不足以覆盖所有场景。

具体排查解决步骤 #

1. 补全superset_config.py配置 #

除已开启的两个功能flag，还需添加必要配置项，否则数据集解析模板变量时会找不到上下文支持：

FEATURE_FLAGS = {
    "ALERT_REPORTS": True,
    "ENABLE_TEMPLATE_PROCESSING": True,
    "DYNAMIC_PLUGINS": True,  # Superset 3.x+版本必须开启，用于支持模板变量的后端处理
}

# 给模板变量添加默认上下文，数据集保存时会用该默认值完成预校验
def jinja_context_additions(context):
    # 可根据需求从请求/用户配置动态取值，至少需设置一个默认值
    return {"custom_revenue_rank_value": 5}

JINJA_CONTEXT_ADDONS = jinja_context_additions

# 若使用Superset 2.x及更早版本，需额外添加以下配置指定允许的自定义变量
# ALLOWED_EXTRA_JINJA_VARS = {"custom_revenue_rank_value"}

修改配置后必须重启Superset服务，否则新配置不会生效。

2. 正确保存带模板变量的数据集 #

不要直接编写SQL后点击保存，按以下流程操作：

• 切换到数据集的参数标签页，添加参数custom_revenue_rank_value，类型选择数字，默认值设为5（需与上下文配置的默认值一致）；
• 返回SQL标签页，确认SQL中的{{ custom_revenue_rank_value }}拼写与参数名完全一致；
• 先点击运行按钮验证SQL能正常返回结果，再执行保存操作。

3. 图表过滤器关联模板变量的正确方式 #

不能直接将模板变量当作普通过滤字段使用：

• 确保数据集已正确定义custom_revenue_rank_value参数；
• 在图表编辑页添加过滤器时，选择数据集参数中的custom_revenue_rank_value，而非直接将模板变量写入过滤规则；
• 若需动态传参，需确认当前用户角色拥有使用模板变量的权限，无管理员限制。

4. 版本兼容性检查 #

• 若使用Superset 2.x及更早版本，模板变量支持存在已知bug，建议升级至3.x稳定版；
• 旧版本中ENABLE_TEMPLATE_PROCESSING的生效逻辑更严格，必须配合ALLOWED_EXTRA_JINJA_VARS指定允许的变量名，否则会被系统拦截。

最易踩的错误点 #

• 拼写错误：变量名的大小写、下划线必须完全一致，例如将custom_revenue_rank_value写成custom_revenueRankValue会直接触发报错；
• 未设置默认值：数据集保存时会预解析SQL，无默认值会导致解析失败，无法完成保存——SQL Lab因手动传参可正常运行，但数据集保存不支持临时传参；
• 未重启服务：修改配置文件后必须重启Superset，否则新配置无法加载生效。

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