JSON 格式大家都熟,但它在不同語言、不同後端實作下的「標準」其實並不統一。本文整理兩個實專案中最常撞到的解析失敗案例。
在不確定後端編碼的情況下,很多人會直接這樣寫:
NSData *data = [NSData dataWithContentsOfURL:[NSURL URLWithString:urlString]]; NSError *error = nil; NSArray *arr = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:&error];
結果 data 明明有內容,arr 卻是 nil,error 是 The operation couldn't be completed. (Cocoa error 3840.)。問了後端才發現,因為資料裡有中文,他用了 GBK 編碼。解法是先轉碼再解析:
NSData *data = [NSData dataWithContentsOfURL:[NSURL URLWithString:urlString]]; NSError *error = nil; NSStringEncoding enc = CFStringConvertEncodingToNSStringEncoding(kCFStringEncodingGB_18030_2000); NSString *dataString = [[NSString alloc] initWithData:data encoding:enc]; NSData *utf8Data = [dataString dataUsingEncoding:NSUTF8StringEncoding]; NSArray *arr = [NSJSONSerialization JSONObjectWithData:utf8Data options:NSJSONReadingMutableContainers error:&error];
標準 JSON 不允許字串中出現未跳脫的 \n、\r、\t 等控制字元,但後端手動拼字串時很容易帶進來。遇到這種狀況,只能在解析前先清洗一遍:
NSData *data = [NSData dataWithContentsOfURL:[NSURL URLWithString:urlString]]; NSError *error = nil; NSStringEncoding enc = CFStringConvertEncodingToNSStringEncoding(kCFStringEncodingGB_18030_2000); NSString *dataString = [[NSString alloc] initWithData:data encoding:enc]; // JSON 中不應出現 \n \r \t 等控制字元,後端輸出有問題時需要過濾 dataString = [dataString stringByReplacingOccurrencesOfString:@"\r\n" withString:@""]; dataString = [dataString stringByReplacingOccurrencesOfString:@"\n" withString:@""]; dataString = [dataString stringByReplacingOccurrencesOfString:@"\t" withString:@""]; NSData *utf8Data = [dataString dataUsingEncoding:NSUTF8StringEncoding]; NSArray *arr = [NSJSONSerialization JSONObjectWithData:utf8Data options:NSJSONReadingMutableContainers error:&error];
除了上述兩點,實務上常見的還有:尾端多餘的逗號(trailing comma)、用單引號包字串、key 沒加引號、日期格式自訂、以及註解沒清乾淨。這些都屬於「非標準 JSON」,靠字串替換只能應付一時,根本解法還是把後端的輸出格式約束起來。
另外別忘了:解析前先檢查 data.length > 0,並在解析後判斷回傳的是 NSDictionary 還是 NSArray,能省下不少排查時間。