---
title: 排查应用连接问题
description: 诊断应用加载、凭证、授权、审查、重新连接和断开连接问题。
---

当应用无法加载、连接、重新连接、保存其工具访问或按预期断开连接时，使用本指南。从 Runner 实际显示的状态开始，而不是盲目重复提供商流程。

**入口路径：** **项目 → 应用**

## 开始前

1. 确认您为预期的项目和工作区打开了应用。
2. 清除**搜索应用**和任何代理应用类别过滤器。
3. 刷新页面一次并等待连接状态加载。
4. 阅读确切的卡状态：**连接**、**连接中...**、**已连接**、**重新连接**、**待审查**或操作所需通知。
5. 仅打开与该状态匹配的恢复操作。
6. 永远不要在支持消息或屏幕截图中包含 API 密钥、密钥、身份文件、支付详情或完整提供商回调 URL。

## 重要控制和结果

| 控制 | 选择后会发生什么 |
| --- | --- |
| **清除搜索** | 删除当前代理应用搜索，以便可用目录可以再次出现。 |
| **连接** / **连接并授权** | 为该应用打开设置或外部授权流程。 |
| **重新连接**（显示时） | 为现有提供商连接重新启动授权。 |
| **重试** | 重复当前面板显示的失败目录、工具列表或连接请求。 |
| **继续入职** | 当需要操作时返回现有 Stripe 入职流程。 |
| **断开连接** | 打开确认或开始记录的删除流程；在更改提供商端凭证前验证保存的状态。 |

## 症状和恢复表

| 您看到的 | 可能的含义 | 安全的下一步操作 |
| --- | --- | --- |
| 应用缺失 | 搜索、类别、工作区访问或条件功能隐藏了它。 | 清除搜索、选择**全部**，然后确认该功能对此工作区可用。 |
| 卡一直在加载 | Runner 尚未解决保存的连接。 | 刷新应用一次。避免在状态未知时提交另一个连接。 |
| **未找到应用** | 没有代理应用与当前过滤器匹配。 | 选择**清除搜索**。 |
| **连接**无反应 | 必需字段为空或无效，或提供商流程无法启动。 | 阅读字段错误、重新复制所需值，并在适用时允许提供商弹出窗口。 |
| **连接中...**未完成 | 外部授权被关闭、阻止或从未返回结果。 | 返回应用、刷新状态，然后如果 Runner 提供，使用**重新连接**。 |
| 提供商显示成功但 Runner 没有 | Runner 尚未确认可用连接。 | 重新打开应用。仅将**已连接**视为成功；使用**重新连接**而不是创建重复项。 |
| **重新连接** | 现有授权需要关注。 | 选择它并再次完成提供商流程。 |
| **待审查** | Stripe 正在审查提交的详情。 | 遵循操作通知；不要仅为了删除标签而启动另一个账户。 |
| **需要 Stripe 操作** | Stripe 需要信息或已暂停功能。 | 查看**立即到期**、**稍后到期**、**审查中**、支付和付款通知，然后在显示时使用**继续入职**。 |
| API 密钥或密钥被拒绝 | 该值错误、已过期、来自错误的账户或此集成不接受。 | 从提供商重新复制。不要凭猜测编辑密钥。 |
| Shopify 域无效 | 该值不是永久 Shopify 商店域。 | 使用 `your-store.myshopify.com`，而不是自定义店面域。 |
| 代理应用授权窗口被阻止 | 浏览器阻止了外部流程。 | 允许 Runner 的弹出窗口并再次启动**连接并授权**。 |
| 代理应用工具加载失败 | Runner 无法检索该应用的工具列表。 | 在**应用详情**中选择**重试**。 |
| 工具开关报告失败 | 新工具设置未保存。 | 等待开关刷新、确认其当前状态，然后重试一次。 |
| 断开连接报告失败 | Runner 未确认删除。 | 假设现有连接仍然活跃，在再次尝试前重新打开应用。 |

## 提供商特定检查

### Stripe

- 使用**重新连接**或**继续入职**继续现有入职尝试。
- 阅读操作要求而不是仅依赖卡颜色。
- 已发布的店面仍可能有支付暂停或不可用。
- 仅在 Runner 有关联账户后使用 Stripe 仪表板操作。

### 电子邮件

- 失败的开关更改返回到保存的状态。
- 启用的开关不能证明特定电子邮件已传递。
- 使用安全测试数据验证商店事件、收件人、电子邮件配置和当前发布的版本。

### Shippo

- 从预期账户重新复制 Shippo API 密钥。
- 已连接的卡不验证费率、承运商、标签或发货创建。

### Shopify

- 使用永久 `myshopify.com` 域。
- 如果工作区已有已连接的商店，请在断开前查看它。
- 当连接链接过期或返回的商店与您输入的域不匹配时重新启动授权。

### CJ Dropshipping

- 确认 API 密钥属于您打算使用的 CJ 账户。
- 断开连接后，Runner 回退到共享 CJ 账户，因此在未来供应商操作前验证账户上下文。

### 4PX

- 确认 API 密钥和密钥属于同一账户并在正确的字段中。
- 已连接的卡不能证明目的地或订单符合履行条件。

### 代理应用

- 整个部分或单个应用可能有条件地不可用。
- 在将应用视为缺失前清除过滤器。
- 在重新连接前查看工具开关；不要仅为了简化设置而授予更多访问权限。

## 断开连接失败或产生不确定的结果

1. 保持提供商账户和当前商店操作不变。
2. 重新打开**项目 → 应用**并检查卡状态。
3. 如果它仍显示已连接，则将连接视为活跃。
4. 在您了解活跃结账、电子邮件、配送、供应商或履行工作是否仍依赖它们之前，不要删除提供商端凭证。
5. 仅在状态清晰后重试 Runner 断开连接。

## 安全地寻求帮助

提供：

- 应用名称；
- 确切的可见状态和错误文本；
- 问题是在连接、返回、管理工具还是断开连接时发生；
- 项目 URL（不含密钥查询值）；以及
- 隐私安全的屏幕截图（如果它实质上显示了问题）。

不要提供实际的 API 密钥、密钥、提供商密码、身份文件、支付详情、客户数据或隐藏的授权参数。

## 相关指南

- [应用和集成概述](../apps-and-integrations)
- [连接、管理和重新连接应用](./connect-manage-reconnect)
- [连接和控制代理应用](./agent-apps)