【Python】requestsのタイムアウト設定は必須！例と注意点

# 基本: 5秒でタイムアウトするGET
import requests
import time

url = "https://httpbin.org/get"  # 動作検証用のパブリックAPI

start = time.monotonic()
resp = requests.get(url, timeout=5)  # 5秒で接続/読み取りの両方がタイムアウト
elapsed = time.monotonic() - start

print("status:", resp.status_code)
print(f"elapsed: {elapsed:.2f}s")
print("ok:", resp.ok)

# 接続3.05秒、読み取り10秒に分けて設定する例
import requests

url = "https://httpbin.org/delay/5"  # 5秒遅延してからレスポンスを返す

# 接続には通常1秒台〜数秒で十分、読み取りは用途により長めに
resp = requests.get(url, timeout=(3.05, 10))
print("status:", resp.status_code)

# タイムアウトを明確に捕捉してハンドリングする例
import requests

url = "https://httpbin.org/delay/5"

try:
    # 接続は短め、読み取りはそこそこ長め
    resp = requests.get(url, timeout=(2, 3))
    resp.raise_for_status()  # HTTPエラー(4xx/5xx)なら例外
    print("success:", resp.json())
except requests.exceptions.ConnectTimeout:
    print("接続がタイムアウトしました(connect timeout)")
except requests.exceptions.ReadTimeout:
    print("読み取りがタイムアウトしました(read timeout)")
except requests.exceptions.Timeout:
    # 上記のサブクラスをまとめて扱いたい場合の保険
    print("タイムアウトが発生しました")
except requests.exceptions.HTTPError as e:
    print("HTTPエラー:", e)
except requests.exceptions.RequestException as e:
    # すべてのrequests例外の最上位。ネットワーク関連のその他の失敗
    print("その他の通信エラー:", e)

# 200ミリ秒待ちたい → 0.2秒を指定する
import requests
from requests.exceptions import ReadTimeout

try:
    requests.get("https://httpbin.org/delay/1", timeout=0.2)
except ReadTimeout:
    print("0.2秒では待ちきれずにタイムアウトしました")

# 到達不能アドレスへの接続でconnect timeoutを短めにする
import requests
from requests.exceptions import ConnectTimeout

try:
    # 10.255.255.1 は多くの環境で到達不能なダミー
    requests.get("http://10.255.255.1", timeout=(1, 5))
except ConnectTimeout:
    print("接続確立までに1秒でタイムアウト(ConnectTimeout)")

# 大きなレスポンスをストリーミングで読む例(読み取りTOを長めに)
import requests

url = "https://nbg1-speed.hetzner.com/100MB.bin"  # 大容量テストファイル(例)
with requests.get(url, stream=True, timeout=(3, 60)) as r:
    r.raise_for_status()
    total = 0
    for chunk in r.iter_content(chunk_size=1024 * 128):  # 128KBごとに読む
        if not chunk:
            continue
        total += len(chunk)
    print("downloaded bytes:", total)

# requests + urllib3 Retry でリトライを組み合わせる例
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

session = requests.Session()

retry = Retry(
    total=3,                # 最大3回リトライ
    backoff_factor=0.5,     # 0.5, 1.0, 2.0秒...と指数的に待つ
    status_forcelist=[429, 500, 502, 503, 504],  # 一時的エラー対象
    allowed_methods=["HEAD", "GET", "OPTIONS", "POST"]  # リトライ許可メソッド
)

adapter = HTTPAdapter(max_retries=retry)
session.mount("http://", adapter)
session.mount("https://", adapter)

try:
    # タイムアウトは毎回明示。Totalではなく(connect, read)で指定
    r = session.get("https://httpbin.org/status/500", timeout=(2, 5))
    r.raise_for_status()
    print("success")
except requests.exceptions.RequestException as e:
    print("失敗:", e)

# 付け忘れ防止の薄いラッパー例
import os
import requests
from typing import Tuple

def default_timeout() -> Tuple[float, float]:
    # 環境変数で上書き可能にする
    connect = float(os.getenv("REQUEST_TIMEOUT_CONNECT", "2.0"))
    read = float(os.getenv("REQUEST_TIMEOUT_READ", "5.0"))
    return (connect, read)

def safe_get(url: str, **kwargs) -> requests.Response:
    # timeout未指定なら自動付与
    if "timeout" not in kwargs:
        kwargs["timeout"] = default_timeout()
    return requests.get(url, **kwargs)

resp = safe_get("https://httpbin.org/get")  # 常にtimeoutが付く
print(resp.status_code)

# 所要時間をログに残して根拠ある調整を可能にする例
import time
import logging
import requests

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger("http")

def timed_get(url: str, timeout=(2, 5)):
    t0 = time.monotonic()
    try:
        r = requests.get(url, timeout=timeout)
        r.raise_for_status()
        return r
    finally:
        elapsed = time.monotonic() - t0
        logger.info("GET %s timeout=%s elapsed=%.2fs", url, timeout, elapsed)

r = timed_get("https://httpbin.org/delay/1", timeout=(1, 3))
print("status:", r.status_code)

# 環境に応じてタイムアウトを切り替える例
# (dev: 短め / prod: 長め)
import os
import requests

ENV = os.getenv("APP_ENV", "dev")

DEFAULT_TIMEOUTS = {
    "dev": (1.0, 3.0),
    "stg": (2.0, 5.0),
    "prod": (3.0, 10.0),
}

def get_timeout():
    base = DEFAULT_TIMEOUTS.get(ENV, DEFAULT_TIMEOUTS["dev"])
    # さらに個別上書きも可能
    c = float(os.getenv("REQUEST_TIMEOUT_CONNECT", base[0]))
    r = float(os.getenv("REQUEST_TIMEOUT_READ", base[1]))
    return (c, r)

resp = requests.get("https://httpbin.org/get", timeout=get_timeout())
print("env:", ENV, "timeout:", get_timeout(), "status:", resp.status_code)