C# WebClient 上傳圖片到 Python 服務器 404 排查清單

現象

C# WinForm 使用 WebClient.UploadFile 或 OpenWrite 上傳圖片到 Python 服務器（https://guanjia.51xueba.cn:2014/upload），始終返回 404，URL 確認無誤。

核心排查邏輯：服務端優先

先看服務端日誌：是否收到請求？收到後是否正確路由處理？是否主動返回 404？

客戶端代碼潛在問題

1. URL 路徑：/upload vs /upload/，Python 框架（Flask/Django/Tornado）路由嚴格區分尾部斜杠。
2. Content-Type：UploadFile 默發 multipart/form-data，服務端需對應解析（如 Flask request.files）。
3. 字段名：服務端期望的文件字段名（如 file、image），客戶端需一致。UploadFile 使用文件名作為字段名，可能不匹配。
4. 大小限制：Nginx/服務端 client_max_body_size 限制導致 413/404。
5. HTTPS/重定向：301/302 重定向時 WebClient 默不攜帶 POST 數據，導致 404。

調試步驟

1. 服務端打印 request.method, request.path, request.headers, request.files。
2. 用 Postman/curl 模擬相同請求，驗證服務端邏輯正常。
3. 抓包對比 Postman 與 C# 客戶端的請求差異（Header、Body、Boundary）。
4. C# 改用 HttpClient + MultipartFormDataContent 精確控制字段名、邊界、Header。

// HttpClient 精確控制示例
using (var client = new HttpClient())
using (var content = new MultipartFormDataContent()) {
    var bytes = File.ReadAllBytes(filePath);
    content.Add(new ByteArrayContent(bytes), "file", "image.jpg"); // 字段名 "file"
    var resp = await client.PostAsync("https://host:2014/upload", content);
    resp.EnsureSuccessStatusCode();
}

**404 多半是服務端路由匹配失敗**，拿到服務端日誌是破局關鍵。