最近公司開發新專案,伺服器端團隊在上海,iPhone 客戶端團隊在瀋陽,跨地溝通不太順暢,結果踩了一個很典型的雷。
原本的介面是採用 XML 格式傳輸資料。後來雙方協調改成 JSON,客戶端也照著改了資料格式,但測試時一直無法通過——伺服器端收到的請求總是解析失敗。
查了半天,最後是去翻伺服器端的錯誤 log 才找到原因。客戶端的程式碼裡,Content-Type 一直還是舊的那一行:
NSString *contentType = [NSString stringWithFormat:@"text/xml"];
[request addValue:contentType forHTTPHeaderField:@"Content-Type"];資料內容已經換成 JSON 了,標頭卻還宣告著 xml。伺服器按著 Content-Type 去選解析器,拿 JSON 的字串餵給 XML parser,當然怎麼樣都過不了。
改成正確的寫法:
NSString *contentType = @"application/json";
[request addValue:contentType forHTTPHeaderField:@"Content-Type"];application/javascript 與 application/json 兩者都能通過(前者是較早期的寫法,JSON-P 場景仍會用到)。問題就此解決。
第一,Content-Type 必須與實際傳輸的格式一致。這是 HTTP 協定最基本的約定,標頭是「宣稱」,body 是「內容」,兩者不符時伺服器沒有義務去猜。發送請求前養成檢查標頭的習慣,能省下大量排查時間。
第二,跨團隊開發時,介面變更要留下紀錄。這次真正的問題其實不是技術,而是溝通:格式改了,但客戶端只知道「要改成 JSON」,沒人提醒他標頭也要一起改。
第三,伺服器端的 log 往往比客戶端的猜測可靠。客戶端這邊只能看到「請求失敗」,資訊量極少;伺服器端的錯誤訊息通常會直接告訴你解析在哪一步炸掉。遇到跨系統的問題,第一步就該去要伺服器 log,而不是在客戶端反覆試。
結論一句話:每次發送資料請求時,務必依實際傳輸的格式設定對應的 Content-Type。