Linux SSH Secure File Transfer 出現 "encountered 1 errors" 解決方案三則

使用 SSH Secure File Transfer Client (Windows 圖形化 SFTP 工具) 上傳檔案時，偶爾會跳出 encountered 1 errors during the transfer 錯誤。本文提供三種由簡入繁的解決方案，涵蓋傳輸模式、檔案衝突、本地路徑問題。

方法一：切換傳輸模式為 Binary (最常見、最快)

1. 開啟 SSH Secure File Transfer Client
2. 選單列：Operation → File Transfer Mode → Binary
3. 重新上傳檔案

原理：預設 ASCII 模式會嘗試轉換換行符 (CRLF ↔ LF)，導致二進位檔案 (圖片、壓縮檔、執行檔) 損壞或校驗失敗。Binary 模式逐位元傳輸，適用所有檔案類型。

方法二：刪除遠端同名檔案後重傳

1. 在遠端目錄刪除同名檔案
2. 重新上傳

適用情境：遠端檔案被鎖定、權限不足、磁碟配額已滿、檔案系統錯誤導致覆寫失敗。

方法三：移動本地檔案至非桌面路徑再上傳

1. 將待上傳檔案從 Desktop 移至其他分區/目錄 (如 D:\Uploads)
2. 重新上傳

適用情境：桌面路徑包含特殊字元、權限受限、OneDrive/雲端同步佔用檔案鎖定、路徑過長超過 Windows MAX_PATH 限制。

進階排查：若上述三法均無效

最佳實踐建議

• **預設設定 Binary 模式**：工具選項中將預設傳輸模式改為 Binary
• **大檔案改用 rsync**：rsync -avz --progress local/ user@host:/remote/ 支援斷點續傳、校驗、壓縮
• **自動化腳本**：使用 scp、lftp 或 sshpass 批次處理

90% 以上的 encountered 1 errors 可透過「切換 Binary 模式」瞬間解決，建議養成預設 Binary 的習慣。