# starlette.websockets.WebSocketDisconnect: 1006

- **ID:** `python/fastapi-websocket-disconnect-loop`
- **领域:** python
- **类别:** network_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

客户端未发送关闭帧即关闭套接字；服务端循环继续调用 receive/send 而未捕获 WebSocketDisconnect。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 0.100+ | active | — | — |
| 0.110+ | active | — | — |

## 解决方案

1. **** (93% 成功率)
   ```
   try:
    while True:
        msg = await ws.receive_text()
        await ws.send_text(msg)
except WebSocketDisconnect:
    pass
   ```
2. **** (88% 成功率)
   ```
   Use ws.iter_text() and break on disconnect; send a ping interval for liveness.
   ```

## 无效尝试

- **** — Hides real errors and leaks sockets; CPU spins on reconnect storms. (70% 失败率)
- **** — close() on a dead socket raises again. (75% 失败率)