> ## 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#應用程式日誌)中寫入警告：

*此端口已失敗 \[次數] 次並進入退避狀態。自動化服務將在 \[日期/時間] 之前跳過該端口。端口會保持退避狀態，直到手動成功傳送或接收訊息、端口設定發生變化，或者自動傳送嘗試成功傳送所有訊息。*

### 未傳送檔案

如果自動化看似已啟用，但端口的**交易**索引標籤中不斷累積狀態為“未傳送”的檔案，原因很可能是退避。請檢查應用程式日誌中的退避警告，並檢視交易日誌中是否存在連續的自動化失敗。

## 退出退避

發生以下任一情況時，端口會自動退出退避：

* 透過手動傳送或接收成功處理一個檔案
* 儲存端口設定
* 自動傳送嘗試成功傳送所有檔案

## 退避機制的作用

如果沒有退避機制，遇到持續性故障（例如端點配置錯誤、憑證過期或網路中斷）的端口會不斷重試，並生成大量失敗日誌和資料庫記錄，最終降低應用程式效能。退避機制可以限制這種影響，同時讓端口在問題解決後立即恢復。