Skip to main content

故障排除

可操作步骤，用于解决开发生命周期中的问题。

“尝试修复”错误循环​

使用 Lovable 进行构建能让编码过程更快、更直观——但即使是最好的 AI 开发工具偶尔也会遇到障碍。有时您的代码无法按预期运行，或者 AI 可能对您的意图产生误解，导致意外行为。

以下是逐步指南，帮助您应对问题并快速恢复正常：

1. 首先使用“尝试修复”按钮​

当错误出现时，点击 尝试修复 按钮。Lovable 会扫描日志、识别问题并尝试快速修复。这是您最快捷的首选方法。如果无效，则需进一步排查。

2. 诊断意外行为​

您的代码可能运行无误，但结果不符合预期。这就是 意外行为——不易察觉且较难修复。建议尝试以下步骤：

  • 查看原始提示，确认您的指令是否清晰。
  • 分解分析：检查各个组件和逻辑细节。
  • 添加视觉辅助：使用截图来清晰描述问题。

3. 编写更有效的提示​

清晰且结构化的提示能带来更好的结果。请采用以下格式：

  1. 项目概述 – 您正在构建什么？
  2. 页面结构 – 列出关键页面或组件。
  3. 导航逻辑 – 描述用户流程。
  4. 视觉辅助 – 上传线框图或截图。
  5. 实施步骤 – 规划构建顺序。

4. 按逻辑顺序构建​

结构至关重要。请遵循以下推荐流程：

  1. 创建布局和页面。
  2. 连接 Supabase 或您的后端。
  3. 设置身份验证和用户角色。
  4. 规划并组织功能逻辑。
  5. 提示 Lovable 实现功能。

5. 使用聊天模式获取清晰指导​

如果不确定，请切换到 聊天模式：

  • 让 Lovable 分析项目状态。
  • 请求 回顾已尝试的解决方案。
  • 寻求 新方向 来解决持续问题。

6. 如果仍未解决：高级策略​

还是无法破解？试试这些方法：

  • 保持精确 – 清晰描述错误及预期结果。
  • 使用图像 – 截图或视频有助于阐明问题。
  • 直接询问 – “我们还能尝试什么？”
  • 回滚操作 – 恢复到稳定版本，然后逐步重建。

什么出了问题？常见故障排除领域​

故障排除通常涉及以下类别：

  1. UI 或布局故障
  2. API 或后端问题
  3. 提示解释错误
  4. AI 无响应或异常行为
  5. 平台或集成错误

一般问题​

需要快速诊断？

进入仅聊天模式并输入：“有些不对劲。你能带我一步步查看发生了什么以及你试过的办法吗？”

UI 或布局问题
  • 检查组件层次和样式设置。
  • 使用截图解释视觉错误。
  • 提示 Lovable：“为什么这个元素不对齐？请修复它。”
完全卡住时
  • 提示：“退一步。分析错误并建议其他方法。”
  • 将任务分解为更小的部分。
  • 如果错误持续，使用回滚按钮。
代码沙盒错误

这不应发生。请向支持团队报告。

未找到预览或沙盒启动中

尝试强制刷新页面。如果仍未解决，请联系支持。

AI 可靠性​

避免提示工程中的 AI 错误
  • 保持提示清晰且结构化。
  • 使用反向元提示技术。
  • 先在仅聊天模式下测试，再应用重大更改。
AI 无响应

这不应发生。请向支持团队报告。

持续的修复错误循环

调整您的提示以帮助 AI 理解目标，或请求逐步调试支持。

重构破坏了一切

进行小幅增量更改。如果问题持续，回滚到稳定版本或在聊天模式中调试。

错误循环、幻觉或逻辑错误

回滚到稳定版本，并在下个提示中提供更多上下文。使用视觉编辑器或附加知识文件。

AI 未进行更改

AI 可能编辑了错误的文件或误解了指令。请尽量具体，或手动进行编辑。

聊天模式无响应或不完整

此问题已由工程团队修复。如果再次出现，请报告。

意外崩溃、错误或循环
  • 不要重复相同的提示。简化或改写提示。
  • 询问：“我们已经试过的修复是什么？”
  • 从之前的稳定状态重新构建。

核心功能​

预览页面是空白的
  • 可能是运行时错误。检查浏览器控制台日志。
  • 使用聊天模式进行故障排除。
  • 尝试强制刷新或执行回滚。
回滚失败

如果无法回滚项目，请向支持团队报告。

取消发布或停用项目

此操作当前不受支持。

被踢出项目

此问题已解决。如果再次发生，请报告。

Remix 不工作（无 Supabase 连接）

这不应发生。请联系支持。

加载配置文件错误

这不应发生。请向支持团队报告。

电子邮件退订不工作

这是一个严重问题，可能与电子邮件提供商相关。请立即联系支持。

意外登出或访问丢失

直接联系支持团队。

大型项目挑战
  • 将大型更改分解为更小的步骤。
  • 如果浏览器变慢，重启浏览器。
  • 如果问题持续，向支持报告您的用例。

域名问题​

自定义域名设置

要将自定义域名连接到您的 Lovable 应用：

  1. 在 Lovable 中导航到 项目 → 设置 → 域名
  2. 点击“添加域名”并输入域名
  3. 根据指示更新 DNS 设置
  4. 等待 DNS 传播（可能需时长达 48 小时）

自定义域名功能需要付费 Lovable 计划。

DNS 配置

示例 DNS 设置，用于您的域名注册商：

# 对于 A 记录 (example.com):  
类型: A  
名称: @  
值: 185.158.133.1  

# 对于 www 子域名:  
类型: CNAME  
名称: www  
值: yourapp.lovable.app

DNS 设置说明：

  • A 记录： 将根域名指向 Lovable 的 IP 地址
  • CNAME 记录： 为 www 创建到 Lovable 应用的别名
  • TTL (生存时间)： 设置为 3600 (1 小时) 或更低，以加速传播

DNS 验证：

要验证 DNS 设置是否正确，可以使用：

SSL 证书问题

Lovable 会自动为自定义域名提供 SSL 证书。如果遇到问题：

  • 确保 DNS 已正确配置
  • 检查域名是否有 CAA 记录限制证书颁发
  • 等待长达 24 小时让证书生效
  • 验证浏览器未缓存旧证书
  • 检查证书透明日志
  • 如果持续问题，联系 Lovable 支持

常见 SSL 错误：

  • ERR_CERT_COMMON_NAME_INVALID： 域名与证书不匹配
  • ERR_CERT_AUTHORITY_INVALID： 证书未被浏览器信任
  • SEC_ERROR_UNKNOWN_ISSUER： 证书颁发者未知
  • SSL_ERROR_BAD_CERT_DOMAIN： 域名与证书不匹配

SSL 安全说明： Lovable 使用 Let's Encrypt 提供证书，有效期 90 天，并自动续期。

部署过程

要部署 Lovable 应用：

  1. 点击右上角的“发布”按钮
  2. 等待构建完成
  3. 应用将可用在 yourapp.lovable.app
  4. 查看部署日志以排查问题

部署策略：

  • 预览部署： 先测试应用再发布到生产环境
  • 自动部署： 配置项目在 Git 更改时自动部署
  • 回滚： 如需，回滚到先前版本
移除 Lovable 徽章

要从部署的应用中移除 Lovable 徽章：

  1. 转到项目设置
  2. 找到“显示 Lovable 徽章”选项
  3. 关闭它（需付费计划）
  4. 重新部署应用

此选项适用于所有付费计划。如果未显示，请检查账单状态。

已发布版本未显示最新版本

当前解决方法是用户需同时添加域名及其 www. 子域名，以确保更新同步。

Supabase 问题​

Edge Functions 错误

为所有凭据采用最小权限原则

在使用 Lovable 与 Supabase 时，请将敏感 API 密钥存储为 Supabase Edge Function 机密，而非环境变量或源代码。

设置环境变量

仔细检查语法和变量名称。请参阅 Supabase 文档。

Supabase 连接丢失

断开并重新连接。可能由集成更新导致。

Remix 与 Supabase 不兼容

出于安全原因，Remix 对于已连接 Supabase 的项目被禁止。

项目未找到

请向支持报告。

HTTP Fetch 失败

通常表示后端服务器未响应。使用聊天模式调试。

连接 Supabase

要将 Lovable 项目连接到 Supabase：

  1. 在编辑器右上角点击 Supabase 菜单
  2. 选择“连接到 Supabase”
  3. 按照提示完成连接
  4. 连接后，Lovable 可查看您的表格、RLS 策略和函数

Stripe 问题​

Stripe 错误

尝试其他卡片或支付方式。如果仍未解决，请联系支持。

两个活跃订阅

别担心——支持团队能轻松处理。

取消订阅

转到设置并通过 Stripe 账户取消。

GitHub 问题​

无法推送到 GitHub

您可能已删除仓库。在此处还原。

分支已损坏

分支切换是实验性功能。请谨慎使用。

连接到 GitHub 后，您可以管理不同分支：

分支切换步骤

# 从 main 切换到 dev:  
1. 在开发模式中，打开 Git 面板  
2. 选择分支下拉菜单  
3. 选择“dev”，或点击“创建新分支”如果不存在  
4. 工作区将更新为所选分支

分支管理：

  • 创建新分支： 在 Git 面板点击“创建新分支”
  • 删除分支： 通过 GitHub 接口操作
  • 默认分支： 在 GitHub 仓库设置中定义

如果无法切换：

  • 提交或暂存未提交更改
  • 检查未跟踪文件
  • 尝试刷新 Lovable 编辑器
仓库同步问题
  • 检查您的 GitHub 权限。
  • 使用回滚撤销不期望的更改。
已删除仓库，现在一切都无法工作
连接 GitHub

要将 Lovable 项目连接到 GitHub：

  1. 在编辑器右上角点击 GitHub 按钮
  2. 授权 Lovable 访问您的账户
  3. 选择创建新仓库或使用现有仓库
  4. 按照提示完成连接

仓库访问级别：

连接时可选择：

  • 所有仓库： 访问所有 GitHub 仓库
  • 仅选定仓库： 仅特定仓库

Lovable 使用 GitHub OAuth 进行安全认证。您可随时撤销访问。

身份验证问题

如果遇到 GitHub 身份验证问题：

  • 在 Lovable 中重新连接账户
  • 检查访问令牌是否过期
  • 验证权限
  • 确保双重认证未干扰
推送失败

如果推送被拒绝：

  1. 从远程仓库拉取最新更改
  2. 解决冲突
  3. 重新尝试推送
  4. 检查分支是否受保护
分支已损坏

这是一个实验性功能，可能偶尔不稳定。

已删除您的仓库

需要更多帮助？​

还是未解决？试试这些：

  1. 使用 聊天模式 获取逐步指导。
  2. 通过 反馈门户 提交报告。
  3. 如果是付费用户，联系 支持。

全面调试手册​

此文档 或 此网站 由 Discord 社区的 Lovable 资深用户撰写。

如何使用它​

  1. 下载 它为 Comprehensive_Debugging_Manual.md。
  2. 上传 它到您的 GitHub 项目。
  3. 提示 Lovable：“阅读此文档。告诉我是否有效。然后创建一个提示，用于故障排除此问题。”
  4. 在 Lovable 响应后，说：“在继续前，详细解释为什么你认为这会起作用。等待我的批准。”

这能确保在实施修复前获得更深入的理解。