Metabase API创建卡片时可选参数被自动填充默认值问题

参数默认值重复问题修复 #

1. 严格区分必填/可选参数的配置结构
   确保可选参数不包含default字段，或者显式将其设为null，避免Metabase自动继承其他参数的默认值。示例配置：

   "parameters": [
     {
       "type": "number",
       "name": "min_duration",
       "slug": "min_duration",
       "default": 69,
       "required": true
     },
     {
       "type": "number",
       "name": "max_duration",
       "slug": "max_duration",
       "required": false
       // 不要添加default字段，或设置为"default": null
     }
   ]
   

2. 验证SQL模板的参数引用逻辑
   确保可选参数在SQL中做了空值兼容处理，比如使用模板条件判断：

   SELECT * FROM your_table
   WHERE duration >= {{min_duration}}
   {% if max_duration %}
     AND duration <= {{max_duration}}
   {% endif %}
   

3. 对齐前端生成的参数结构
   通过浏览器开发者工具抓取前端创建卡片的请求，对比自己的API请求参数，重点检查slug、id等隐式必填字段——Metabase对这些字段的唯一性有要求，缺失或重复可能导致参数逻辑异常。

文档缺失问题的替代方案 #

• 导出已有卡片的配置作为参考：在Metabase界面创建一个参数配置正确的卡片，通过卡片右上角的...菜单选择「导出问题定义」，直接复用导出的JSON结构来构造API请求。
• 调用元数据API获取示例：通过GET /api/question/{已存在的问题ID}接口，获取正确配置的卡片详情，对比自己的请求参数差异。
• 查阅社区资源：Metabase的GitHub Issues和官方论坛中，很多用户分享了API参数配置的实战细节，搜索相关关键词（比如parameters default value duplicate）能找到针对性的解决方案。

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