> ## 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.

# 端口退避

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

export const siteNameShort = "知行之桥";

export const siteName = "知行之桥";

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

## 退避的触发条件

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

## 延迟机制

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

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

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

## 识别退避状态

### UI 指示器

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

<img src="https://mintcdn.com/qiao/wjl62Js5487vomFe/public/images/connector-backoff.png?fit=max&auto=format&n=wjl62Js5487vomFe&q=85&s=c4047eb64f2280187132f87aa58ac5ae" alt="显示退避状态指示器的端口" width="700" data-path="public/images/connector-backoff.png" />

### 应用程序日志

端口进入退避时，{siteNameShort} 会在[应用程序日志](../getting-started/administration/activity#应用程序日志)中写入警告：

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

### 未发送文件

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

## 退出退避

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

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

## 退避机制的作用

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