必须启用 ENABLE_EMBEDDING=true 并重启服务，嵌入 URL 需用 SECRET_KEY_BASE 签名，iframe 要配置 CSS 响应式及权限策略，参数须严格匹配变量名与格式。
Metabase 嵌入前必须开启 ENABLE_EMBEDDING
不启用这个环境变量，所有嵌入链接都会返回 400 错误或空白页，不是前端问题，是后端直接拒掉请求。enable_embedding 必须设为 true，且只在 metabase 启动时读取一次——改完要重启服务。
- Docker 启动：加
-e ENABLE_EMBEDDING=true - JAR 启动：加
-Dmb.enable-embedding=true - Windows/Linux 服务：确保配置写进
metabase.jar启动脚本里，别只改了 .env 文件却没生效
仪表盘嵌入要用 iframe，但 URL 必须带签名
Metabase 不允许裸 URL 嵌入，哪怕你开了 embedding，没签名的 iframe src 会跳转到登录页或报 Invalid embedding parameters。签名不是前端拼的，得后端用 SECRET_KEY_BASE 算 HMAC-SHA256。
- 不能手写时间戳、不能漏
resource字段、不能把dashboard写成dashboards - 签名原文格式固定：
{"resource":{"dashboard":123},"params":{},"exp":1735689600}（注意数字 ID，不是 slug） - 生成后的完整 URL 长这样：
https://your-metabase.com/embed/dashboard/xxx#bordered=true&titled=true，xxx是 base64url 编码+签名串
iframe 加载后无法响应式？关键是 allowtransparency 和 CSS 控制
默认 iframe 宽高写死会导致在移动端切屏时错位或留白，Metabase 自身不处理容器 resize，得靠外层控制。
- 必须去掉
frameborder="0"（已废弃），改用 CSS：iframe { border: none; } - 推荐用 padding-bottom 百分比实现等比缩放，比如
aspect-ratio: 16/9（Chrome 110+ 支持，旧版用position: relative + padding-bottom技巧） - 加
allow="clipboard-read; clipboard-write"，否则图表里的复制按钮点不动
用户权限和 params 传参容易被忽略的细节
嵌入后看到“无权限访问此内容”，大概率不是链接错了，而是 dashboard 里用了未授权的数据源字段，或者 params 传了空值但卡片没设默认值。
-
params必须和 dashboard 中定义的变量名完全一致（大小写敏感），例如变量叫city_name，就不能传city - 如果参数是日期范围，传
"start": "2024-01-01"没用，得传 ISO 格式带时区："start": "2024-01-01T00:00:00Z" - 嵌入用户看不到的卡片，即使整个 dashboard 共享了，也会在 iframe 里显示为空白区域——Metabase 不隐藏，而是不渲染
Metabase 嵌入真正卡住人的地方，从来不是怎么写 iframe，而是签名逻辑散落在文档角落、权限继承关系不透明、还有那个必须重启才生效的 ENABLE_EMBEDDING。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
