明明設定了 timeoutInterval,卻完全沒作用:
NSMutableURLRequest *request = [NSMutableURLRequest
requestWithURL:self.address
cachePolicy:NSURLRequestReloadIgnoringLocalAndRemoteCacheData
timeoutInterval:self.defaultTimeout];
timeoutInterval 形同虛設,請求會一直掛在那裡直到很久以後才失敗。
這個問題只在 iOS 3.0 及其後的版本出現,而且只有在你呼叫了 setHTTPBody: 之後才會發生。這是蘋果在 iOS 3.0 中對 URL Loading System 所做的一項調整。
實際行為是:一旦設定了 HTTP body 的 data,系統會把 request 的 timeout 強制改為 240 秒,而且這個值無法被覆寫——即使你在 setHTTPBody 之後再次設定 timeoutInterval,用 NSLog 印出 [request timeoutInterval] 得到的仍然是 240。
蘋果開發人員對此的解釋是:開發者自己設定的 timeout 通常太短,其實沒有實質意義。尤其在行動網路上,光是「bring WWAN interface up」(讓 WWAN 介面就緒)就可能耗掉不少時間,你若設 10 秒,往往連介面都還沒建立完成就逾時了。因此系統主動給了一個下限。
理由可以理解,但這個設計讓「我想要 30 秒逾時」這種合理需求無法表達,實務上只能說是個設計缺陷。
思路很直接:既然系統不讓我控制,那我自己用 NSTimer 計時,時間到就主動中止連線。做法略顯笨拙,但確實有效。
NSMutableURLRequest *request = [NSMutableURLRequest
requestWithURL:self.address
cachePolicy:NSURLRequestReloadIgnoringLocalAndRemoteCacheData
timeoutInterval:self.defaultTimeout];
NSData *bodyData = [outputBodydataUsingEncoding:NSUTF8StringEncoding];
if (cookies != nil) {
[request setAllHTTPHeaderFields:[NSHTTPCookie requestHeaderFieldsWithCookies:cookies]];
}
[request setValue:@"wsdl2objc" forHTTPHeaderField:@"User-Agent"];
[request setValue:soapAction forHTTPHeaderField:@"SOAPAction"];
[request setValue:@"text/xml; charset=utf-8" forHTTPHeaderField:@"Content-Type"];
[request setValue:[NSString stringWithFormat:@"%u", [bodyData length]]
forHTTPHeaderField:@"Content-Length"];
[request setValue:self.address.host forHTTPHeaderField:@"Host"];
[request setHTTPMethod:@"POST"];
[request setHTTPBody:bodyData];
NSURLConnection *connection = [[NSURLConnection alloc] initWithRequest:request delegate:operation];
// 自訂逾時
[NSTimer scheduledTimerWithTimeInterval:self.defaultTimeout
target:self
selector:@selector(handleTimer)
userInfo:operation
repeats:NO];
operation.urlConnection = connection;
[connection release];
計時器到期時,人為製造一個錯誤並交給操作物件處理:
// 逾時處理
- (void)handleTimer {
[operationCopy connection:[NSError errorWithDomain:@"時間超時!"
code:256
userInfo:nil]];
}
一、請求成功時要取消計時器。上面的範例中,NSTimer 建立後沒有保留參考,成功情況下也無法 invalidate。實務上請把 timer 存成實例變數,在 connectionDidFinishLoading 與 didFailWithError 中都呼叫 invalidate,否則 timer 會在逾時時間到後仍然觸發 handleTimer,對一個已完成的連線再送一次錯誤,造成邏輯錯亂。
二、handleTimer 中的 operationCopy 語意不明。從 context 傳遞物件、再在回呼中取出使用是可行的,但 timer 的 userInfo 已經被用來傳 operation 了。若要在 handleTimer 中操作該 operation,應直接透過實例變數存取,或改用 block 版本的 timer 以捕獲變數,避免再引入一層不明來源的中間變數。
這個問題在 NSURLSession 時代已經不復存在。timeoutIntervalForRequest 與 timeoutIntervalForResource 這兩個組態在設定了 HTTPBody 之後依然有效,不必再自己寫計時器:
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration]; config.timeoutIntervalForRequest = 30; // 連線逾時 config.timeoutIntervalForResource = 60; // 整體資源逾時 NSURLSession *session = [NSURLSession sessionWithConfiguration:config];
兩者的差異值得記住:timeoutIntervalForRequest 是「等待資料的間隔上限」,只要還有資料持續傳來就不會逾時,適合控制伺服器回應的延遲;timeoutIntervalForResource 則是整個請求的總時長上限,包含所有重試與等待,適合限制大檔案下載的總時間。
若你正在維護的是仍在使用 NSURLConnection 的舊專案,那麼「自己開 timer」依然是唯一可行的路;但如果是新專案,請直接改用 NSURLSession,這個坑連踩的機會都不會有。