Android HttpClient 連線與 Socket 超時設定：避免請求無限等待

預設 HttpClient 無超時限制，伺服器無回應時請求會無限阻塞，導致 ANR 或使用者體驗極差。必須明確設定**連線超時**與 **Socket 讀取超時**。

核心程式碼 (Apache HttpClient / DefaultHttpClient)

HttpGet httpGet = new HttpGet(url);

HttpParams httpParams = new BasicHttpParams();

// 1. 連線超時：建立 TCP 連線的最長等待時間 (毫秒)
int connectionTimeout = 3000; // 3 秒
HttpConnectionParams.setConnectionTimeout(httpParams, connectionTimeout);

// 2. Socket 讀取超時：等待資料傳輸的最長間隔 (毫秒)
int socketTimeout = 5000; // 5 秒
HttpConnectionParams.setSoTimeout(httpParams, socketTimeout);

// 3. 套用參數建立 Client
DefaultHttpClient httpClient = new DefaultHttpClient(httpParams);

// 4. 執行請求
HttpResponse response = httpClient.execute(httpGet);

超時類型差異對照

現有 HttpClient 套用參數

若已有 DefaultHttpClient 或 AndroidHttpClient 實例：

httpClient.setParams(httpParams);

現代替代：OkHttp / Retrofit (強烈推薦)

Apache HttpClient 於 Android 6.0 移除，Android 9.0 完全不可用。新專案請直接使用 OkHttp 或 Retrofit：

OkHttp 設定超時

OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(3, TimeUnit.SECONDS)      // 連線超時
    .readTimeout(10, TimeUnit.SECONDS)        // 讀取超時
    .writeTimeout(10, TimeUnit.SECONDS)       // 寫入超時
    .callTimeout(30, TimeUnit.SECONDS)        // 整體呼叫超時 (OkHttp 4.9+)
    .build();

Request request = new Request.Builder().url(url).build();
try (Response response = client.newCall(request).execute()) {
    // 處理回應
}

Retrofit 設定超時

OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(3, TimeUnit.SECONDS)
    .readTimeout(10, TimeUnit.SECONDS)
    .build();

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .client(client)
    .addConverterFactory(GsonConverterFactory.create())
    .build();

最佳實務清單

• ✅ 所有網路請求**必須**設定超時
• ✅ 區分連線超時與讀取超時，依業務調整
• ✅ 使用 OkHttp/Retrofit 取代舊 HttpClient
• ✅ 實作重試機制（指數退避）處理暫時性超時
• ✅ 監控超時率，作為效能優化依據

正確設定超時，是打造穩健網路層的第一步。

1. 上一篇文章： Android 透明 Activity 實作：主題樣式設定與應用場景
2. 下一篇文章： Android 網路連線檢查：ConnectivityManager 正確用法與 InetAddress 陷阱

程式設計綜合問答

C 語言 scanf 輸入無反應？緩衝區殘留換行符與格式字符串陷阱完整排查

初學 C 語言時常遇到：程序運行到 scanf 輸入數字後按

檢查一條數據在某個時間段是否重復，在線求 SQL

檢查同一個客戶的合同在同一個時間段內是否有重復，可使用以下

C語言指針數組遍歷陷阱：指針修改導致原數組地址被改變的深度分析

問題代碼 char *p[] = {to,yes,is o

jQuery EasyUI Combogrid 數據顯示完整指南

常見問題 Combogrid 下拉框無數據，通常是 colu