解決 FTP「基礎連線已關閉：伺服器提交了協定衝突」C# 完整排查指南

FtpWebRequest 協定衝突錯誤根因與三種解決方案

使用 `FtpWebRequest.GetResponse()` 連接特定 FTP 伺服器時拋出「The underlying connection was closed: The server committed a protocol violation」，但 FileZilla、WinSCP 等用戶端正常。經排查，主因在於 **伺服器回應不符合 RFC 959/2428 標準**（如多行回應格式錯誤、狀態碼異常），導致 .NET 內建 FTP 解析器拋出例外。

重現代碼片段

var req = (FtpWebRequest)WebRequest.Create($"ftp://{host}:{port}/");
req.Credentials = new NetworkCredential(user, pass);
req.Method = WebRequestMethods.Ftp.ListDirectory;
req.UseBinary = true;
req.UsePassive = true; // 關鍵嘗試
using (var resp = (FtpWebResponse)req.GetResponse()) // 這裡拋出 ProtocolViolationException
using (var reader = new StreamReader(resp.GetResponseStream()))
    Console.WriteLine(reader.ReadToEnd());

方案一：啟用 `useUnsafeHeaderParsing`（最快生效）

.NET 配置選項允許寬鬆解析不標準 HTTP/FTP 標頭。在 `app.config` / `web.config`：

<system.net>
  <settings>
    <httpWebRequest useUnsafeHeaderParsing="true" />
  </settings>
</system.net>

或運行時代碼（需反射，因屬性 `internal`）：

var settings = typeof(System.Net.Configuration.SettingsSection).GetSection("system.net/settings");
var prop = settings.GetType().GetProperty("HttpWebRequest", BindingFlags.NonPublic | BindingFlags.Instance);
var httpSettings = prop.GetValue(settings);
var unsafeProp = httpSettings.GetType().GetProperty("UseUnsafeHeaderParsing", BindingFlags.NonPublic | BindingFlags.Instance);
unsafeProp.SetValue(httpSettings, true);

方案二：改用 `FtpWebRequest` 低階 Socket 或第三方庫

• FluentFTP（推薦）：`NuGet Install FluentFTP`，支援非標準伺服器、TLS/SSL、非同步、大檔案斷點續傳。

  using var conn = new FtpClient(host, user, pass);
  conn.Connect();
  foreach (var f in conn.GetListing()) Console.WriteLine(f.Name);

• Rebex FTP/SSL：商業庫，相容性極佳。
• Raw Socket 實作 FTP 指令：完全控制，但需自行處理協定細節（PASV/EPSV、多行回應、編碼）。

方案三：伺服器端修正（根治）

若可控制 FTP 伺服器（如 vsftpd、ProFTPD、FileZilla Server、IIS FTP）：

• 升級至最新版，修正已知協定合規性 Bug。
• 檢查 `ftpd.log` 確認回應格式：每行必須以 `` 或 `-` 開頭，結尾 `\r\n`。
• 關閉不必要的擴展指令（如 `MLST`、`UTF8`）測試是否為特定指令觸發。