Java HttpURLConnection setFollowRedirects 失效原因與正確用法

調用 HttpURLConnection.setFollowRedirects(false) 後仍發生重定向，是常見坑。本文揭示根本原因：靜態方法必須在獲取連接實例前調用，並給出正確代碼模式。

問題現象

URL url = new URL("https://example.com");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setFollowRedirects(false); // 錯誤：實例方法不存在，且靜態方法已失效
// 實際仍會自動重定向

根本原因

• setFollowRedirects(boolean) 是 靜態方法，影響後續創建的所有 HttpURLConnection 實例的默認行為。
• 若在 openConnection() 之後調用，當前實例已按默認值 true 初始化，修改無效。
• 實例方法 setInstanceFollowRedirects(boolean) 才控制單個實例行為，但必須在 connect() 前調用。

正確用法

方案一：全局設置（影響所有後續連接）

// 必須在任何 openConnection() 之前
HttpURLConnection.setFollowRedirects(false);

URL url = new URL("https://example.com");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
// 此連接不會自動重定向

方案二：單實例設置（推薦，粒度更細）

URL url = new URL("https://example.com");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setInstanceFollowRedirects(false); // 僅影響此連接
conn.connect();

驗證代碼

HttpURLConnection.setFollowRedirects(false);
URL url = new URL("https://httpbin.org/redirect/1");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
System.out.println("Response Code: " + conn.getResponseCode()); // 302
System.out.println("Location: " + conn.getHeaderField("Location")); // 獲取重定向地址
// 不會自動跳轉，需手動處理

最佳實踐建議

1. 優先使用 setInstanceFollowRedirects(false)，避免全局副作用。
2. 若需手動處理重定向，讀取 Location 標頭並發起新請求，注意攜帶 Cookie。
3. 生產環境建議使用 Apache HttpClient 或 OkHttp，重定向策略可配置更靈活。

記住：靜態設置要早，實例設置要早於 connect()，即可精準控制重定向行為。