以下是一個來自百度圖片「風景」分類的查詢網址:
NSString *const kWebsite = @"https://image.baidu.com/search/index?tn=baiduimage&ipn=r&ct=201326592&cl=2&lm=-1&st=-1&fr=&sf=1&fmq=1459502303089_R&pv=&ic=0&nc=1&z=&se=1&showtab=0&fb=0&width=&height=&face=0&istype=2&ie=utf-8&word=風景";
拿這個字串去發請求,會直接拋出 Unsupported URL 之類的錯誤,連線根本建立不起來。

URL 只允許使用 ASCII 字元集中的合法字元。中文、空白、以及部分符號都屬於「必須轉義」的字元,若直接放進 NSURL 的初始化方法中,就會得到 nil,後續請求自然失敗。
使用 stringByAddingPercentEncodingWithAllowedCharacters: 做一次百分比編碼(Percent Encoding),把非 ASCII 字元轉成 %XX 形式:
NSString *urlString = [kWebsite
stringByAddingPercentEncodingWithAllowedCharacters:
[NSCharacterSet URLQueryAllowedCharacterSet]];
這樣 word=風景 就會被轉成合法的編碼形式,請求即可正常送出。
URLQueryAllowedCharacterSet 適用於 query 部分。如果整串都要編碼,可改用 URLFragmentAllowedCharacterSet 或自訂「字母數字」白名單,避免把 ?、&、= 等結構性字元一起編碼掉,那樣反而會破壞網址結構。NSURLComponents 搭配 queryItems 組裝參數,讓系統替你處理編碼細節,可以少踩很多坑。「請求失敗」的背後常常只是編碼問題。養成把使用者輸入或外部取得的中文參數統一編碼的習慣,能省下不少排查時間。若有任何疑問,歡迎留言討論。