故障排除预览和发布

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

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

本指南内容

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

为什么这个区别很重要

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

可用性和先决条件

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

找到失败的层

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

重要恢复控制

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

状态到操作参考

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

向 Runner 报告问题

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

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

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

恢复边界

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