---
title: 连接 Shopify 商店
description: 围绕现有 Shopify 商店创建 Runner 项目，同时在 Shopify 中保持结账。
---

**本指南内容：** 您将启动 Shopify 授权或为新 Runner 项目重用符合条件的 Shopify 连接。

当您的目录和结账已在 Shopify 中运行时，使用此路径。

**入口路径：** 工作区**主页** → **+ 商店** → **连接 Shopify**。

## 开始前

- 您的工作区必须启用**连接 Shopify**。
- 您需要以 `.myshopify.com` 结尾的商店永久域。
- 对于新连接，您需要权限在 Shopify 中批准访问。
- 您的 Runner 工作区必须有空间容纳另一个商店。

## 创建商店控件

| 控件 | 为什么有用 | 选择后会发生什么 |
| --- | --- | --- |
| **连接 Shopify** 项目类型 | 保持现有的 Shopify 商务系统。 | 显示 Shopify 连接选择和商店域字段。 |
| **商店名称** | 命名 Runner 项目。 | 在 Runner 工作区中使用；它不重命名 Shopify 商店。 |
| **使用现有连接：_domain_** | 避免为符合条件的连接重复授权。 | 为新 Runner 项目选择该 Shopify 连接。 |
| **连接不同的商店** | 从另一个 Shopify 商店开始。 | 显示**商店域**。 |
| **商店域** | 标识 Shopify 商店。 | 接受诸如 `your-store.myshopify.com` 的域。 |
| **连接 Shopify** 提交按钮 | 启动新授权。 | 将您发送到 Shopify；Runner 仅在 Shopify 成功返回后完成交接。 |
| **创建** | 使用选定的现有连接。 | 创建 Runner 项目并打开它。 |
| **取消** | 不连接或创建而离开。 | 关闭对话。 |

## 连接新的 Shopify 商店

1. 选择**+ 商店**，然后选择**连接 Shopify**。
2. 为 Runner 项目输入**商店名称**。
3. 如果显示连接选择，选择**连接不同的商店**。
4. 在**商店域**中输入完整的 `.myshopify.com` 域。
5. 选择**连接 Shopify**。
6. 在 Shopify 上审查访问请求，仅当它命名您期望的商店时才继续。
7. Shopify 返回到 Runner 后，确认新项目出现在工作区中。

## 重用现有连接

1. 在**创建商店**中选择**连接 Shopify**。
2. 输入 Runner**商店名称**。
3. 选择**使用现有连接：_domain_**。
4. 选择**创建**。

## 故障排除

| 状态 | 含义 | 处理方法 |
| --- | --- | --- |
| Shopify 选项缺失 | 此工作区未启用该功能。 | 使用**构建新的**或检查工作区可用性。 |
| **连接 Shopify** 已禁用 | 商店名称或 `.myshopify.com` 域不完整。 | 更正突出显示的字段。 |
| 连接已链接 | 该 Shopify 连接属于另一个 Runner 商店。 | 选择另一个符合条件的连接或不同的商店。 |
| 连接未找到 | 保存的连接不再可用。 | 选择另一个连接或启动新授权。 |
| Shopify 授权已取消 | Shopify 未返回批准的连接。 | 返回**创建商店**并在准备好时重试。 |

此项目类型的结账保持在 Shopify 中。成功的连接不能证明
Runner 店面已构建或发布；分别审查这些状态。

## 相关指南

- [改为创建 Runner 商店](./create-runner-store.mdx)
- [构建您的第一个商店](./first-store-quickstart.mdx)
- [入门](./)