进阶 drawdb.app 2026-11-13 08:22:38 · 14 阅读
第15章 drawDB Pro 常见问题排查
第15章 排查 drawDB Pro 常见问题
解决 drawDB Pro 常见的登录、云端保存、工作区、邀请、共享、协作、AI、计费、API 密钥及 MCP 问题。请先定位下方列出的症状,并在执行可能替换或删除数据的恢复步骤前,保留导出的图表文件。
账户与验证
| 症状 | 处理方法 |
|---|---|
| 验证邮件未送达 | 核对邮箱地址,检查垃圾邮件文件夹,等待重新发送代码,或申请新的验证码。 |
| 验证码过期或错误 | 仅使用最新代码。如有需要,待计时结束后申请新代码。 |
| 验证尝试次数过多 | 停止重复尝试,等待认证限制重置。 |
| OAuth 链接过期或被拒绝 | 返回 drawDB 重新发起登录,切勿复用回调 URL。 |
| GitHub 登录提示无已验证邮箱 | 在 GitHub 中添加并验证主邮箱,或改用邮箱/Google 登录。 |
参考:账户、个人资料与登录
云端图表与访问
图表仍为本地状态:在已登录状态下打开图表,点击云端横幅中的“移动”选项。首先确认目标工作区,然后等待保存完成状态。
云端保存失败:保持标签页开启,检查网络连接,并尝试小幅编辑以重试。若错误持续存在,请将图表导出至本地。切勿假设未保存的修改已同步至云端。
图表为仅查看模式:当前成员权限或订阅计划不允许写入操作。若仅单个图表受限,请请求创建者或团队管理员授予“可编辑”权限;若整个工作区均为只读,请检查“设置 → 计费”。
图表所属团队已移除本人:请请求团队管理员重新邀请正确账户。云端访问权限跟随当前工作区成员状态。
共享
| 症状 | 处理方法 |
|---|---|
| 共享控件提示图表未保存 | 将图表移至云端并等待保存完成。 |
| 共享控件提示图表为空 | 至少添加一个表。 |
| 常规复制链接无法访问 | 确认接收者已登录、属于该团队,且拥有图表访问权限。 |
| 公开链接应停止生效 | 撤销或禁用公开共享;仅将替换链接发送给目标查看者。 |
| 成员无法编辑 | 将其权限修改为“可编辑”,并确认图表受众允许其访问。 |
参考:共享 Pro 图表与管理权限
团队邀请
| 错误 | 解决方案 |
|---|---|
| 邀请过期或被撤销 | 请求管理员创建新的邀请。 |
| 使用被邀请邮箱登录 | 退出登录,并使用确切的目的地地址。 |
| 已是成员 | 切换工作区,而非重复接受邀请。 |
| 达到团队试用席位上限 | 撤销未使用的待处理邀请,或移除未使用成员。 |
| 邀请邮件未送达 | 撤销待处理邀请,并重新邀请该地址。 |
实时协作
- 琥珀色圆点:等待首次云端保存或连接尝试。
- 红色圆点 — 功能要求:该工作区未启用 Team Pro 协作。
- 红色圆点 — 禁止访问:账户缺少编辑权限。
- 红色圆点 — 非云端存储:请先保存或移动图表。
- 红色圆点 — 网络/服务器:检查连接后重载一次;正常的云端编辑功能可能仍可用。
参考:实时协作
版本与 AI
| 症状 | 处理方法 |
|---|---|
| 记录版本不可用 | 将图表保存至云端,确认拥有编辑权限且 Pro 计划处于活跃状态。 |
| 提示“没有需要保存的更改” | 当前模式与最新记录版本一致。 |
| 迁移无 SQL 输出 | 通用图表仅支持 JSON 对比,或模式无结构性变更。 |
| AI 提示打开已保存图表 | 将新画布保存为本地或云端图表,使其拥有 ID。 |
| AI 请求被锁定 | 登录或恢复活跃的云端访问权限。 |
计费激活
若结账保持挂起状态,请让激活检查完成,重新打开编辑器,并检查“设置 → 计费”。在未确认首次支付失败前,不要重复结账。若激活仍未显示,请联系支持团队。
API 密钥与 MCP
常见 MCP 错误记录在“使用 MCP 连接 drawDB 到 AI 工具”中。若令牌丢失或泄露,请创建替代密钥,更新客户端,验证后删除旧密钥。
联系支持
打开账户设置对话框,并使用“社区”查找可用的 drawDB 链接。报告问题时请包含:
- 工作区及图表名称(切勿包含 API 密钥或私有共享令牌)。
- 确切的可见错误信息。
- 图表是本地(Local)还是云端(Cloud)。
- 浏览器及操作系统版本。
- 问题发生的大致时间。
在 GitHub 上编辑 | 最后更新于:使用 MCP 连接 drawDB 到 AI 工具
配置 MCP
配置只读 drawDB MCP 服务器,使 Claude Desktop、Cursor、Cline、Goose、Windsurf 及兼容客户端能够检查云端模式。
创建数据库图表
创建 drawDB 图表,添加表和字段,定义索引和关系,并导出数据库模式。