本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

疑難排解 SFTP 連接器問題

本節說明 SFTP 連接器問題的可能解決方案。

針對為您的 SFTP 連接器新增受信任主機金鑰進行故障診斷

Description

當您建立或編輯 SFTP 連接器，並新增信任的主機金鑰時，您會收到下列錯誤： Failed to edit connector details (Invalid host key format.)

原因

如果您貼入正確的公有金鑰，問題可能是您已包含金鑰comment的部分。 目前 AWS Transfer Family 不接受金鑰的註解部分。

解決方案

當您將金鑰貼入文字欄位時，請刪除金鑰的註解部分。例如，假設您的金鑰看起來類似以下內容：

ssh-rsa AAAA...== marymajor@dev-dsk-marymajor-1d-c1234567.us-east-1.amazon.com

移除==字元後面的文字，並只貼到 和包含 的索引鍵部分==。

ssh-rsa AAAA...==

金鑰交涉失敗

Description

您收到金鑰交換交涉失敗的錯誤。例如：

Key exchange negotiation failed due to incompatible host key algorithms. 
Client offered: [ecdsa-sha2-nistp256, ecdsa-sha2-nistp384,
ecdsa-sha2-nistp521, rsa-sha2-512, rsa-sha2-256] Server offered: [ssh-rsa]

原因

此錯誤是因為伺服器支援的主機金鑰演算法與連接器支援的主機金鑰演算法之間沒有重疊。

解決方案

確保遠端伺服器支援錯誤訊息中列出的至少一個用戶端主機金鑰演算法。如需支援的演算法清單，請參閱 AWS Transfer Family SFTP 連接器的安全政策。

SFTP 連接器限流

Description

使用 SFTP 連接器進行檔案傳輸時，您遇到以下錯誤：

{"type":"ExecutionThrottled","details":{},"connectorId":"c-1234567890abcdef0"}

或者，您注意到檔案傳輸在大量操作期間發生延遲或間歇性失敗。

原因

SFTP 連接器具有限制並行檔案傳輸和 API 操作數量的服務配額。超過這些限制時，會發生限流以保護服務並確保所有客戶的公平使用。

解決方案

若要解決 SFTP 連接器問題，請嘗試下列解決方案：

最佳化 SFTP 連接器效能

Description

您的 SFTP 連接器傳輸速度比預期慢，或者效能不一致。

原因

SFTP 連接器效能可能會受到各種因素的影響，包括網路條件、檔案大小、遠端伺服器組態和並行傳輸限制。

解決方案

若要最佳化 SFTP 連接器效能：

故障診斷 VPC 連線問題

本節說明啟用 VPC_LATTICE 的 SFTP 連接器常見問題的解決方案。

連接器卡在待定狀態

Description

啟用 VPC_LATTICE 的 SFTP 連接器會長時間處於 PENDING 狀態 （超過 10 分鐘）。

原因

這可能是因為 DNS 解析延遲、資源閘道組態問題或 VPC Lattice 服務網路關聯問題而發生。

解決方案

聯絡 AWS 支援 聯絡 AWS。以協助分析問題的根本原因。您也可以嘗試以下解決方法。

連接器處於 ERRORED 狀態

Description

啟用 VPC_LATTICE 的 SFTP 連接器會顯示ERRORED狀態與錯誤詳細資訊。

原因

常見原因包括資源組態 ARN 無效、VPC 子網路中 IP 地址不足，或跨區域資源共用嘗試。

解決方案

不支援公有 IP 地址錯誤

Description

嘗試使用公有 IP 地址建立資源組態時，您會收到錯誤： ValidationException: IP address x.x.x.x is not in allowed ranges.

原因

公有端點的資源組態必須使用 DNS 名稱，而非 IP 地址。

解決方案

建立資源組態時，請使用 SFTP 伺服器的公有 DNS 名稱，而非其 IP 地址：

aws vpc-lattice create-resource-configuration \
    --name my-public-server-config \
    --resource-gateway-identifier rgw-1234567890abcdef0 \
    --resource-configuration-definition dnsResource={domainName="my.sftp.server.com"} \
    --port-ranges 22

不支援可用區域錯誤

Description

您在建立資源閘道時收到錯誤： Subnet subnet-xxx is not valid because it is not in a supported Availability Zone.

原因

並非所有可用區域都支援 VPC Lattice 跨 VPC 資源存取。錯誤訊息會列出您所在區域的支援 AZs。

解決方案

使用 VPC_LATTICE 連接器的連線逾時

Description

透過 VPC 連接器的檔案傳輸會逾時或間歇性失敗。

原因

VPC Lattice 具有連線限制 （每個資源 350 個連線） 和閒置逾時 (TCP 為 350 秒）。

解決方案

其他 SFTP 連接器問題

Description

您在執行 後收到錯誤StartFileTransfer，但不知道問題的原因，而且在 API 呼叫後只會傳回連接器 ID。

原因

此錯誤可能有幾個原因。若要疑難排解，建議您測試連接器並搜尋 CloudWatch 日誌。

解決方案