最近在實作 POST 請求時遇到一個狀況:只要參數裡含有中文,請求就會失敗。以下用兩種寫法對比說明問題與解法。
做法是先把主機位址與查詢字串拼接成完整的 URL,接著用 NSURL URLWithString: 建立 NSURL,再包成 NSMutableURLRequest 以 POST 送出,最後用同步方式取得回應資料。
問題在於,當參數含中文時,直接建立 NSURL 會觸發 NSURLErrorDomain Code=-1002 "unsupported URL" 錯誤。這裡有個小技巧:在取得資料為 nil 時把 error 印出來,就能快速看到失敗的真正原因,並跳出「網路不穩」的提示。
其實兩段程式碼幾乎一模一樣,關鍵差異只有一行:在建立 NSURL 之前,先用 stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding 把整個 URL 字串做一次百分比編碼,再交給 NSURL URLWithString:。
這樣一來,中文參數會被正確轉義,請求就能順利送出,伺服器端也能收到完整的內容。
只要 URL 或參數可能出現中文等非 ASCII 字元,就務必在建立 NSURL 前進行 URL 編碼。此外,養成在錯誤分支印出 error 的習慣,能幫你快速定位問題根源。