呼叫外部 API 時,網路抖動、服務暫時不可用會導致請求失敗。簡單重試機制能大幅提升系統健壯性。
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}")
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
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 次