排查应用连接问题
诊断应用加载、凭证、授权、审查、重新连接和断开连接问题。
当应用无法加载、连接、重新连接、保存其工具访问或按预期断开连接时，使用本指南。从 Runner 实际显示的状态开始，而不是盲目重复提供商流程。
入口路径： 项目 → 应用
开始前
- 确认打开的是目标项目和工作区的应用页面。
- 清空搜索工具及 Agent 应用类别筛选条件。
- 刷新一次，等待连接状态加载。
- 阅读准确卡片状态：连接、正在连接…、已连接、重新连接、等待审核或待处理提示。
- 仅打开与该状态对应的恢复操作。
- 支持消息和截图中切勿包含 API 密钥、Secret、身份证明、支付详情或完整的提供方回调 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 帐户。
- 断开后，在恢复有效连接前，后续由商家授权的 CJ 搜索、导入、结账和供应商操作会受限。
- 重新连接同一 CJ 帐户并检查已有导入。如果商品的供应商身份或实时数据已不匹配，请移除后重新导入。
4PX
- 确认 API 密钥和密钥属于同一账户并在正确的字段中。
- 已连接的卡不能证明目的地或订单符合履行条件。
代理应用
- 整个区域或单个应用可能因条件限制而不可用。
- 判断应用缺失前，请先清除筛选条件。
- 重新连接前，请检查工具开关；不要只为简化设置而授予更多权限。
断开连接失败或产生不确定的结果
- 保持提供方帐户和当前商店运营不变。
- 重新打开项目 → 应用，检查卡片状态。
- 如果仍显示已连接，请将连接视为活跃。
- 在明确线上结账、邮件、配送、供应商或履约是否仍依赖这些凭据前，不要删除提供方侧凭据。
- 只有状态明确后，才重试 Runner 中的断开操作。
安全地寻求帮助
提供：
- 应用名称；
- 确切的可见状态和错误文本；
- 问题是在连接、返回、管理工具还是断开连接时发生；
- 项目 URL（不含密钥查询值）；以及
- 隐私安全的屏幕截图（如果它实质上显示了问题）。
不要提供实际的 API 密钥、密钥、提供商密码、身份文件、支付详情、客户数据或隐藏的授权参数。
清空搜索和筛选条件后仍找不到工具时，使用申请应用（空结果中可能显示申请此应用）。表单用于申请提供方支持，不会建立连接。CJ 连接问题请打开一件代发供应商设置。