故障排除预览和发布

将店铺前台、构建、发布、结账和域名状态与最安全的下一步操作相匹配。

入口路径： 工作区 → 选择一个店铺 → 店铺前台 → 重现屏幕上显示的预览或发布状态

本指南内容

识别哪个层失败——项目版本、预览、构建检查、发布、公共目录、结账或域名——并采取最小的安全恢复操作。

为什么这个区别很重要

店铺前台旅程有几个独立的层。重复发布无法修复缺失的产品数据，刷新预览无法修复支付连接。从确切的消息和失败的表面开始。

可用性和先决条件

保持项目打开并记下当前版本标签。
记录确切的消息、页面路径以及它是在预览还是公共 URL 上出现的。
在启动冲突的恢复操作前等待活动的 Runner 工作达到已完成、失败或已停止。
不要仅为了测试理论而删除域名、恢复版本或重复付费操作。

找到失败的层

在店铺前台中，检查是否存在当前版本。
确认正常预览是否打开。
如果您正在发布，在选择另一个操作前阅读构建检查的结果。
如果发布成功，打开公共 URL 而不是预览 URL。
在公共店铺上，测试目录和购物车。
检查 Runner 的结账状态和实际结账路径。
如果仅自定义地址失败，最后检查域名设置。

重要恢复控制

控制	选择时会发生什么
预览中的刷新	重新加载当前预览并清除活动的设计模式选择和撤销/重做会话。首先保存待处理的直接编辑。
修复 / 修复错误	将显示的预览诊断作为修复请求发送给 Runner。关闭仅隐藏消息。
使用 AI 修复	关闭发布确认并将其构建失败发送给 Runner 进行修复；发布不开始。
重试检查	在 Runner 无法到达工作区后再次运行店铺前台构建检查。
打开店铺运营	关闭发布确认并打开店铺运营，以便您可以完成命名的设置。
重试设置状态	在其状态不可用后再次检查店铺运营就绪情况。
重新发布	在失败或无链接结果后启动新的检查发布尝试。首先修复命名的原因。
重试结账状态	再次检查启用的支付连接；它不测试产品、运输或结账表单。

英文标注指出了操作位置。点击图片可放大查看。

构建通过与设置警告可能同时出现。决定商店是否就绪前，请同时阅读两者。（英文界面）

状态到操作参考

消息或症状	层	它的含义	最安全的下一步操作
没有就绪的店面版本	项目版本	没有可预览版本。	请 Runner 搭建首个店面。
正在构建第一个版本…	项目版本	Runner 仍在创建它。	遵循任务进度；还不要发布。
版本上的构建失败	项目版本	该版本还没有准备好。	打开任务详情并要求 Runner 修复失败。
准备预览…	预览	Runner 正在启动选定的预览。	保持最新版本选中；仅当进度停止时才刷新。
无法加载此版本的预览	预览	无法显示选定的版本。	返回当前、刷新或尝试另一个就绪版本。
重新连接预览	预览	Runner 丢失了预览连接并正在重试。	遵循重试计数；如果恢复失败，请重新连接工作区。
带有修复的预览错误栏	预览	运行的页面报告了 Runner 可以使用的诊断。	选择显示更多检查它、修复或修复错误将其发送给 Runner，或仅关闭隐藏栏。
页面未找到	预览或公共路由	该路径在该版本中不存在。	返回 `/`，使用可见导航，并要求 Runner 创建或修复路由。
设计模式未启动	设计模式	可编辑的预览还没有准备好。	选择重试，或返回当前预览并刷新。
Runner 处理完成后，您可以继续进行可视化编辑。	设计模式	Runner 正在处理其他请求。	等待 Runner 完成。
无法加载版本历史	版本历史	版本列表请求失败。	选择重试。
恢复被阻止	版本历史	Runner 活跃或版本还没有准备好。	等待 Runner，然后选择一个就绪版本。
无法连接您的工作区。请重试检查以继续。	发布检查	Runner 无法执行构建检查。	选择重试检查；反复出现时重新连接工作区。
您的商店尚无法构建，因此不能上线。让 Runner 修复错误后再发布。	发布检查	当前店面无法通过构建。	选择使用 AI 修复，检查修复后重新运行检查。
仍有一些运营资料需要处理。您可以现在上线，再到商店运营中完成。	发布设置	重要商店运营设置尚未完成。	选择打开商店运营。只有有意接受限制时，才确认风险。
无法验证商店运营。请重试，或确认后仍然发布。	发布设置	设置状态未知。	考虑确认风险前，先选择重试设置状态。
发布前，请对店面进行可见修改。	发布更改	Runner 未发现自上次发布以来的新内容。	取消，先完成目标修改。没有可发布更改时，确认不可用。
顾客可以浏览，但还不能付款 — 请在设置中连接 Stripe 以接受订单。	结账设置	某些发布流程在未找到已启用支付连接时，会在上线前显示此提示。	原生 Runner 商店请连接 Stripe；只有有意进行仅浏览上线时才确认风险。其他流程在发布后报告结账状态。
店铺发布失败	发布	尝试未完成。	修复命名的问题，然后选择重新发布。
发布完成，带有店铺链接不可用	发布交接	尝试完成但 Runner 中的交接中没有可用的公共 URL。	关闭对话框，确认工作区准备好，然后选择重新发布。
公共店铺显示旧内容	发布或版本	当前项目更改未上线。	确认最新当前版本、选择发布更改并重新打开公共 URL。
公共店铺上缺少产品	目录	发布成功，但预期的产品不可见。	检查产品状态、市场、价格和库存；如果需要，发布更改。
购物车操作缺失或禁用	目录或可用性	选定的项目当前无法添加。	检查必需的选项、可用性、库存、价格和地区。
结账已暂停	支付	发布后流程未找到启用的 Stripe 连接。	选择连接 Stripe，然后重新测试实际结账路径。
结账状态不可用	支付状态	Runner 无法确认支付就绪情况。	选择重试结账状态并独立测试公共结账。
自有自定义域名显示红色警告和类型 / 主机记录 / 值表格	域名	提供商的当前配置检查尚未通过。	将显示的值原样复制到提供商。域设置保持打开时，Runner 会自动重新检查；没有手动验证按钮。
转移进行中	域名	域名在店铺之间移动。	不要启动另一个转移；遵循显示的状态。

确认已恢复

返回发生问题的同一页面、版本和设备尺寸。将最小失败步骤重复一次，检查可见结果：预览就绪、发布成功且公开 URL 显示目标页面、购物车正确，或域名正常。仍失败的步骤请分别记录。

向 Runner 报告问题

在一条消息中包括这些详情：

确切的页面路径或公共 URL；
它是在预览还是实时店铺上失败的；
当前版本标签；
确切的错误或状态文本；
您选择的最后一个按钮；
预期结果；和
在记录的重试操作后问题是否重现。

对于视觉问题，包括设备布局和屏幕截图。对于结账，在真实费用前停止并报告最后成功的步骤。

恢复边界

不要重复恢复或重新发布未更改的失败状态。首先修复命名的原因。
当 Runner 正在工作时不要恢复较旧的版本。
不要删除域名来修复店铺前台或结账问题。
在公共 URL、预期目录、购物车和必需的结账步骤都已检查后，不要声称启动成功。