> ## 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-Hant/getting-started/administration/dashboard.md#關鍵指標)區段顯示了**處於退避狀態的端口**小工具，處於退避狀態的端口會顯示在其中。

### 應用程式日誌

端口進入退避時，知行之橋 會在[應用程式日誌](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/getting-started/administration/activity.md#應用程式日誌)中寫入警告：

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

### 未傳送檔案

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

## 退出退避

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

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

端口退出退避後，自動化狀態卡片上的**狀態**會從**已暫停**變回**閒置**（如果正在執行，則為**進行中**）。

## 退避機制的作用

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


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