# httpx 连接超时：5000 毫秒后连接超时

- **ID:** `python/starlette-http-connection-timeout`
- **领域:** python
- **类别:** network_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

Starlette 应用尝试连接外部服务时，网络请求超时

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.10 | active | — | — |
| 3.11 | active | — | — |

## 解决方案

1. **增加超时时间并添加重试机制** (85% 成功率)
   ```
   client = httpx.AsyncClient(timeout=10.0)
for i in range(3):
    try:
        response = await client.get(url)
        break
    except httpx.ConnectTimeout:
        await asyncio.sleep(1)
   ```
2. **检查网络连接和服务可用性** (90% 成功率)
   ```
   ping example.com
curl -v http://example.com
   ```

## 无效尝试

- **无限增加超时时间** — 掩盖了根本问题，且可能导致资源耗尽 (60% 失败率)
- **忽略异常而不重试** — 请求失败可能导致数据不一致 (80% 失败率)