# RuntimeError: WebSocket connection closed unexpectedly

- **ID:** `python/starlette-websocket-connection-closed`
- **Domain:** python
- **Category:** network_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

客户端或服务器端非正常关闭WebSocket连接

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.x | active | — | — |

## Workarounds

1. **在WebSocket处理中添加重连逻辑** (90% success)
   ```
   async def websocket_endpoint(websocket):
    await websocket.accept()
    try:
        while True:
            data = await websocket.receive_text()
    except WebSocketDisconnect:
        print('Client disconnected')
   ```
2. **使用心跳检测保持连接** (85% success)
   ```
   async def heartbeat(websocket):
    while True:
        await asyncio.sleep(30)
        await websocket.send_text('ping')
   ```

## Dead Ends

- **尝试重新连接而不处理关闭原因** — 未处理关闭原因可能导致无限重连 (50% fail)
- **在接收消息时不检查连接状态** — 已关闭的连接无法接收消息 (40% fail)