2025 最新 Swift 檔案上傳教學 💾

在這篇文章中，我們將深入探討如何使用 Swift 進行檔案上傳到伺服器。隨著 Swift 語言的發展，檔案上傳的方式也有所更新。我們將使用 URLSession 來完成這個任務，這是當前最佳的做法。

Swift 檔案上傳的基本步驟

以下是 Swift 檔案上傳的基本步驟：

建立一個 URLRequest 物件，並將它設定為 POST 方法。
將檔案的資料轉換成 Data 物件。
將 Data 物件設定為 URLRequest 物件的 HTTPBody 屬性。
設定 Content-Type 標頭，以便伺服器識別檔案類型。
建立一個 URLSession 物件，並使用 dataTask 方法。
將 URLRequest 物件傳入 dataTask 方法中。
執行 dataTask 方法，並將檔案上傳到伺服器。

程式碼範例

以下是一個簡單的 Swift 程式碼範例，可以讓你快速地將檔案上傳到伺服器：

let url = URL(string: "http://example.com/upload")!
var request = URLRequest(url: url)
request.httpMethod = "POST"

// 設定Content-Type
request.setValue("application/octet-stream", forHTTPHeaderField: "Content-Type")

let fileURL = URL(fileURLWithPath: "path/to/your/file") // 請替換為你的檔案路徑
let fileData = try Data(contentsOf: fileURL)
request.httpBody = fileData

let session = URLSession.shared
let task = session.dataTask(with: request) { (data, response, error) in
    if let error = error {
        print("上傳失敗：\(error.localizedDescription)")
        return
    }
    if let response = response as? HTTPURLResponse, response.statusCode == 200 {
        print("上傳成功！")
    } else {
        print("上傳失敗，狀態碼：\(response?.statusCode ?? 0)")
    }
}
task.resume()

上述程式碼建立了一個 URLRequest 物件，設定為 POST 方法，並將檔案的資料轉換為 Data 物件。記得要將檔案的路徑替換為實際的路徑。此外，我們也設定了 Content-Type 標頭，以便伺服器正確識別檔案類型。最後，執行 dataTask 方法即可將檔案上傳到伺服器。

錯誤排除

在進行檔案上傳時，可能會遇到以下錯誤：

檔案路徑錯誤：確保你提供的檔案路徑是正確的。
伺服器回應錯誤：檢查伺服器的狀態碼，了解上傳是否成功。
網路問題：確認設備是否連接到網路。

延伸應用

除了基本的檔案上傳，還可以考慮以下應用：

使用 Alamofire 來簡化網路請求。
實現檔案上傳進度顯示功能。
將上傳的檔案與伺服器資料庫進行關聯。

Q&A（常見問題解答）

1. 如何確認檔案是否成功上傳？

你可以檢查伺服器的回應狀態碼，若為 200 則表示成功上傳。

2. 如果遇到上傳失敗，該怎麼辦？

首先檢查網路連接，然後確保檔案路徑和伺服器端的設定正確。此外，可以查看錯誤訊息以進一步調查問題。

3. 可以上傳多個檔案嗎？

是的，可以透過建立多個 URLRequest 物件並分別執行 dataTask 方法來實現多檔案上傳。

—

2025 最新 Swift 檔案上傳教學 💾 – 完整步驟與實作範例