--- title: "排障指南" description: "处理画布编辑、导入、生成、预览、导出、资产和 MCP 连接中的常见问题。" locale: "zh" section: "FAQ" updated: "2026-06-22" source: "https://flare.design/zh/docs/troubleshooting" --- # 排障指南 处理画布编辑、导入、生成、预览、导出、资产和 MCP 连接中的常见问题。 > 分类: FAQ [HTML](https://flare.design/zh/docs/troubleshooting) | [Markdown](https://flare.design/zh/docs/troubleshooting/index.md) 当工作流表现和预期不一致时，可以先按这份清单检查。 ## 快速诊断 | 现象 | 先检查 | 相关指南 | | ---------------- | ----------------------------------- | ------------------------------------------------------------ | | 导入结果坏掉 | 简化来源，并确认图片已加载 | [把 HTML 粘贴进画布](/zh/docs/paste-html-into-canvas) | | 图层选不中 | 用图层面板，或隐藏重叠图层 | [画布基础](/zh/docs/canvas-basics) | | 预览不是目标场景 | 预览前先选中目标 frame | [时间轴和动效](/zh/docs/timeline-and-motion) | | 导出失败 | 先试更短或更低分辨率的小样 | [预览和导出 MP4](/zh/docs/preview-and-export-mp4) | | 生成结果不稳定 | 减少变量，一次只比较一个变化 | [选择生成模型](/zh/docs/choose-generation-models) | | MCP 客户端连不上 | 检查 endpoint、scopes 和 OAuth 连接 | [配置 flare.design MCP](/zh/docs/configure-flare-design-mcp) | ## 导入结果不对 HTML 或 Figma 粘贴前，先简化来源。尽量复制真实文字和已加载图片，避免过深 wrapper；不支持的复杂效果可以在画布里重建。 HTML 适合复制已经能在浏览器里正确渲染的结构。Figma 里只复制真正需要的 frame 或图层，不要连同外层大 workspace 一起复制。 ## 图层难以选中 使用图层面板、放大画布，或临时隐藏附近图层。如果内容在 frame 里，先选中 frame 会更容易理解嵌套关系。 如果选中 group 后影响太多内容，展开 group，直接选择子图层。找到重要图层后顺手命名。 ## 动效预览和版式不一致 先选中目标 frame，并从这个 frame 预览。检查图层开始和结束时间、隐藏状态、视频 trim handles，以及是否有 active motion clips。 如果图层出现得太早或太晚，先调整 layer range，再调关键帧。Range 通常比自定义 motion clip 更容易判断。 ## MP4 导出失败 先尝试导出更短的 frame。本地浏览器导出需要 WebCodecs 支持，如果不可用，建议用较新的 Chromium 系浏览器测试。 云渲染失败时，先看任务开始前的报价，并确认 workspace 有对应套餐额度或 Flares 余额。 ## 生成结果不稳定 把 prompt 收敛到主体、风格、比例和用途。一次只比较一个模型或参数变化。 可以保留一个小的模型比较 frame。把输出按最终尺寸放进去，并加真实文案一起判断，不要只看单张预览。 ## MCP 授权失败 重新连接客户端，确认 resource URL 是 `https://mcp.flare.design/mcp`，并且只请求任务真正需要的 scopes。 如果授权后缺少某个工具，检查请求的 OAuth scopes 是否包含对应读写能力。先用能支持 workflow 的最小 scope 集合，再重新连接。 ## 什么时候联系支持 记录项目名、workspace、浏览器、大致发生时间，以及失败动作。MCP 问题还要带上客户端名称、请求的 scopes，以及 OAuth 是否在 tool call 失败前完成。不要在支持消息里发送 secret 或 bearer token。