> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 端口退避

> 知行之桥端口退避机制的工作方式、触发条件、识别方法和解决方式。

当端口在自动处理中反复发送文件失败时，知行之桥 会让该端口进入**退避状态**。在退避期间，自动化服务会暂时停止受影响端口的发送尝试，让你有时间修复根本问题，同时保护系统性能。

## 退避的触发条件

如果端口连续三个自动化周期都未能成功发送任何文件，就会触发退避。某一周期中仅有一个文件失败而其他文件成功不会触发退避；该周期中的所有文件都必须失败。

## 延迟机制

端口进入退避后，自动化服务会按逐步增加的延迟跳过该端口：

| 失败轮次 | 下次尝试前的延迟 |
| - | - |
| 第一次 | 60 分钟 |
| 第二次 | 120 分钟 |
| 后续每次 | 继续增加，最长为 12 小时 |

端口成功退出退避后，延迟会重置。

## 识别退避状态

### UI 指示器

端口处于退避状态时，会显示状态指示器，说明当前处于退避状态以及自动化服务下次计划运行的时间。退避状态发生变化时（例如手动发送成功或保存了设置），该指示器会自动更新。

![显示退避状态指示器的端口](https://mintcdn.com/qiao/4hcVjuRd69QHuQ3V/26.4/images/connector-backoff.png?fit=max\&auto=format\&n=4hcVjuRd69QHuQ3V\&q=85\&s=a82cc9bcaf37bbf543503e0586870bce)

### 自动化状态卡片

**自动化状态**卡片会显示在**接收**、**下载**和**定时发送**自动化的**自动化**选项卡上。其他自动化类型（例如**发送**）不会显示该卡片。

端口处于退避状态时，该卡片的**状态**显示为**已暂停**。**上次处理结果**保留上一次实际执行的运行结果（通常为**失败**），因为在退避结束之前，自动化服务会跳过该端口。

点击**已暂停**旁边的**查看详情**，可打开**自动化暂停详情**对话框。该对话框列出处于退避状态的每个实例、其失败次数，以及自动化服务恢复的时间。

![自动化暂停详情对话框](https://mintcdn.com/qiao/4hcVjuRd69QHuQ3V/26.4/images/automation-suspend-details.png?fit=max\&auto=format\&n=4hcVjuRd69QHuQ3V\&q=85\&s=b75ac8c277c10ede149a54c33fb8bba1)

### 仪表板

如果你在仪表板的[关键指标](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/dashboard.md#关键指标)部分显示了**处于退避状态的端口**小组件，处于退避状态的端口会显示在其中。

### 应用程序日志

端口进入退避时，知行之桥 会在[应用程序日志](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md#应用程序日志)中写入警告：

*此端口已失败 \[次数] 次并进入退避状态。自动化服务将在 \[日期/时间] 之前跳过该端口。端口会保持退避状态，直到手动成功发送或接收消息、端口设置发生变化，或者自动发送尝试成功发送所有消息。*

### 未发送文件

如果自动化看似已启用，但端口的**交易**选项卡中不断累积状态为“未发送”的文件，原因很可能是退避。请检查应用程序日志中的退避警告，并查看事务日志中是否存在连续的自动化失败。

## 退出退避

发生以下任一情况时，端口会自动退出退避：

* 通过手动发送或接收成功处理一个文件
* 保存端口设置
* 自动发送尝试成功发送所有文件

端口退出退避后，自动化状态卡片上的**状态**会从**已暂停**变回**空闲**（如果正在运行，则为**进行中**）。

## 退避机制的作用

如果没有退避机制，遇到持续性故障（例如端点配置错误、证书过期或网络中断）的端口会不断重试，并生成大量失败日志和数据库记录，最终降低应用程序性能。退避机制可以限制这种影响，同时让端口在问题解决后立即恢复。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.