---
title: 故障排除预览和发布
description: 将店铺前台、构建、发布、结账和域名状态与最安全的下一步操作相匹配。
---

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

## 本指南内容

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

## 为什么这个区别很重要

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

## 可用性和先决条件

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

## 找到失败的层

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

## 重要恢复控制

| 控制 | 选择时会发生什么 |
| --- | --- |
| 预览中的**刷新** | 重新加载当前预览并清除活动的设计模式选择和撤销/重做会话。首先保存待处理的直接编辑。 |
| **修复** / **修复错误** | 将显示的预览诊断作为修复请求发送给 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 报告问题

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

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

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

## 恢复边界

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

## 相关指南

- [预览您的店铺](./preview-your-store)
- [准备发布](./prepare-to-publish)
- [发布和重新发布](./publish-and-republish)
- [验证实时店铺和结账](./live-store-and-checkout)
- [连接自定义域名](./custom-domains)