萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python HTTP 請求自動重試裝飾器:優雅處理暫時性網路故障

問題背景

呼叫外部 API 時,網路抖動、服務暫時不可用會導致請求失敗。簡單重試機制能大幅提升系統健壯性。

裝飾器實作 (Python 2 風格)


def retry(max_retries=2, exceptions=(Exception,), delay=1, backoff=2):
    """通用重試裝飾器
    :param max_retries: 最大重試次數
    :param exceptions: 捕獲的異常類型元組
    :param delay: 初始延遲秒數
    :param backoff: 指數退避倍數
    """
    def decorator(func):
        def wrapper(*args, **kwargs):
            retries, current_delay = 0, delay
            while True:
                try:
                    return func(*args, **kwargs)
                except exceptions as e:
                    if retries >= max_retries:
                        raise  # 重試耗盡,拋出原始異常
                    retries += 1
                    print(f"[{func.__name__}] 第 {retries} 次重試,{current_delay}s 後重試... 錯誤: {e}")
                    time.sleep(current_delay)
                    current_delay *= backoff
        return wrapper
    return decorator

使用範例


import urllib2
import time

@retry(max_retries=3, delay=1, backoff=2)
def fetch_data(url):
    req = urllib2.Request(url, headers={'User-Agent': 'Python-urllib'})
    resp = urllib2.urlopen(req, timeout=10)
    return resp.read()

# 呼叫
try:
    data = fetch_data('https://api.example.com/data')
except Exception as e:
    print(f"最終失敗: {e}")

Python 3 現代寫法 (支援非區域變數)


import functools
import time
import random

def retry(max_retries=3, exceptions=(Exception,), delay=1, backoff=2, jitter=0.1):
    def decorator(func):
        @functools.wraps(func)
        def wrapper(*args, **kwargs):
            retries = 0
            current_delay = delay
            while True:
                try:
                    return func(*args, **kwargs)
                except exceptions as e:
                    retries += 1
                    if retries > max_retries:
                        raise
                    # 指數退避 + 抖動,避免驚群效應
                    sleep_time = current_delay + random.uniform(0, jitter)
                    print(f"重試 {retries}/{max_retries} 等待 {sleep_time:.1f}s: {e}")
                    time.sleep(sleep_time)
                    current_delay *= backoff
        return wrapper
    return decorator

進階:針對特定 HTTP 狀態碼重試


import requests
from requests.adapters import HTTPAdapter
from requests.packages.urllib3.util.retry import Retry

def requests_retry_session(
    retries=3,
    backoff_factor=0.5,
    status_forcelist=(500, 502, 503, 504),
    session=None
):
    session = session or requests.Session()
    retry = Retry(
        total=retries,
        read=retries,
        connect=retries,
        backoff_factor=backoff_factor,
        status_forcelist=status_forcelist,
        allowed_methods=frozenset(['GET', 'POST', 'PUT', 'DELETE'])
    )
    adapter = HTTPAdapter(max_retries=retry)
    session.mount('https://', adapter)
    session.mount('https://', adapter)
    return session

# 使用
session = requests_retry_session()
resp = session.get('https://httpbin.org/status/500')  # 會自動重試 3 次

最佳實踐原則

  1. 冪等性:僅對冪等操作 (GET、PUT、DELETE) 重試,POST 需業務層面支援冪等鍵。
  2. 指數退避 + 抖動:避免大量客戶端同時間重試癱瘓服務。
  3. 設定上限:最大重試次數、總超時時間,防止無限等待。
  4. 區分錯誤類型:網路錯誤、5xx 重試;4xx (除 429) 不重試。
  5. 記錄日誌:記錄重試次數、錯誤詳情,便於事後分析。
copyright © 萬盛學電腦網 all rights reserved