iOS 網路請求裡最常被使用的框架大概就是 AFNetworking。它是一個輕量級的網路通訊庫,架構在 NSURLConnection 以及 iOS 7.0 之後推出的 NSURLSession 之上,把許多網路通訊功能包得很乾淨。它支援 HTTP 請求與 REST 風格的網路服務(GET、POST、PUT 等),並且支援 ARC。
使用 AFN 時最常遇到的錯誤,幾乎都出在預設的資料解析格式與伺服器實際回傳格式不一致。AFN 預設幫你把回應序列化成 JSON、把參數序列化成 NSData;只要對不上,就會拋出解析錯誤,導致請求或回應失敗。下面分別說明兩個方向的解法。
response 預設會把資料轉成 JSON。如果伺服器回的就是 JSON,那沒問題;但若回的是 HTML、純字串或其他格式,就必须改掉預設行為——讓它原封不動地把資料交回來。不過原始資料是二進位,人看不懂,需要自己轉成字串(alloc + initWithData)。
解法重點:把 responseSerializer 換成 AFHTTPResponseSerializer,並在 acceptableContentTypes 中補上 text/html、text/plain 等實際會遇到的型別。







// 請求百度,這是最常見的錯誤情境
- (void)demo {
// 使用自訂的、繼承自 AFHTTPSessionManager 的管理者
NetWorkTools *netWorkTool = [NetWorkTools sharedNetWorkTools];
/**
* 回應回來時,預設的序列化方法是 JSON
* 這裡改用普通序列化方式,原樣取回二進位 HTML
*/
netWorkTool.responseSerializer = [AFHTTPResponseSerializer serializer];
[netWorkTool GET:@"https://www.baidu.com" parameters:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nonnull responseObject) {
NSLog(@"%@--%@", responseObject, [responseObject class]);
// 把二進位資料轉成 HTML 字串
NSString *html = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
NSLog(@"html = %@", html);
} failure:^(NSURLSessionDataTask * _Nonnull task, NSError * _Nonnull error) {
NSLog(@"%@", error.localizedDescription);
}];
}
// NetWorkTools.m
#import "NetWorkTools.h"
static NSString * const BASEURL = @"";
@implementation NetWorkTools
static NetWorkTools *_netWorkTools;
+ (instancetype)sharedNetWorkTools {
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
_netWorkTools = [[self alloc] initWithBaseURL:[NSURL URLWithString:BASEURL]];
// 補上伺服器實際會回傳的 content type
_netWorkTools.responseSerializer.acceptableContentTypes =
[NSSet setWithObjects:@"application/json", @"text/json",
@"text/javascript", @"text/html", @"text/plain", nil];
});
return _netWorkTools;
}
@end
反方向的問題也一樣惱人。request 預設會把參數編成 NSData,但如果後端是 PHP 且只接受 JSON 格式,就必須改用 AFJSONRequestSerializer,否則伺服器無法反序列化。
補充一點常被忽略的知識:並不是所有資料都能轉成 JSON。可轉的情況包括:



- (void)demo1 {
// POST 請求:攜帶使用者資訊的參數建議用 POST,
// 因為不會被快取、沒有長度限制,也不會暴露在 URL 後方,相對安全
NSDictionary *params = @{
@"username": @"abc",
@"password": @"123"
};
NetWorkTools *netWorkTool = [NetWorkTools sharedNetWorkTools];
// 後端是 PHP,只接受 JSON,因此請求序列化器要換掉
netWorkTool.requestSerializer = [AFJSONRequestSerializer serializer];
// 回應仍是原始二進位
netWorkTool.responseSerializer = [AFHTTPResponseSerializer serializer];
[netWorkTool POST:@"https://localhost/post/postjson.php"
parameters:params
success:^(NSURLSessionDataTask * _Nonnull task, id _Nonnull responseObject) {
NSLog(@"%@--%@", responseObject, [responseObject class]);
// 把二進位轉成 text/plain
NSString *result = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
NSLog(@"result = %@", result);
} failure:^(NSURLSessionDataTask * _Nonnull task, NSError * _Nonnull error) {
NSLog(@"%@", error.localizedDescription);
}];
}
AFN 出錯九成不是網路問題,而是序列化器選錯了。記住這兩條對照關係就好:伺服器回什麼格式,responseSerializer 就要能對應(非 JSON 用 AFHTTPResponseSerializer 自己轉字串);伺服器要什麼格式,requestSerializer 就要產生什麼(PHP 吃 JSON 就用 AFJSONRequestSerializer)。把可接受型別補齊,錯誤自然消失。