1 错误翻译

原文：Unable to connect to API (ConnectionRefused)
译文：无法连接到 API（连接被拒绝）

2 原因分析

根本原因： 客户端尝试连接 API 服务器时，目标服务器主动拒绝了连接请求。

常见原因：

| 可能原因 | 说明 |
|---------|------|
| 服务未启动 | 目标服务进程未运行或已崩溃 |
| 端口配置错误 | 目标端口与服务监听端口不一致 |
| 火墙/网络限制 | 安全组或防火墙阻止了连接 |
| 地址错误 | API 主机地址（IP/域名）配置有误 |
| ⚡ 服务过载 | 服务器资源耗尽，拒绝新连接 |

> ⏱️ 当前状态：第 4 次重试（共 10 次），间隔 4 秒

3决方案

排查步骤：

bash
1. 检查目标服务是否运行

ps aux | grep api
或

systemctl status your-api-service
2. 检查端口是否在监听

netstat -tlnp | grep <端口号>
或

ss -tlnp | grep <端口号>
3. 测试端口连通性

telnet  <端口>
或

curl -v http://:<端口>/health
4. 检查防火墙规则

iptables -L -n
或

ufw status

代码层面修复示例：

python
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry
session = requests.Session()
retries = Retry(
    total=5,
    backoff_factor=1,
    status_forcelist=[500, 502, 503, 504]
)
session.mount('http://', HTTPAdapter(max_retries=retries))
try:
    response = session.get('http://your-api:port/endpoint', timeout=10)
except requests.exceptions.ConnectionError:
    print("API 服务不可用，请检查服务状态")

4. 预防措施