# fastapi.WebSocketDisconnect: code=1006, reason=''

- **ID:** `python/fastapi-websocket-disconnect-error`
- **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端点中捕获断开异常** (95% success)
   ```
   from fastapi import WebSocketDisconnect
async def websocket_endpoint(websocket: WebSocket):
    await websocket.accept()
    try:
        while True:
            data = await websocket.receive_text()
    except WebSocketDisconnect:
        print('Client disconnected')
   ```
2. **实现自动重连逻辑** (85% success)
   ```
   async def connect_with_retry():
    while True:
        try:
            await websocket.accept()
            break
        except WebSocketDisconnect:
            await asyncio.sleep(1)
   ```

## Dead Ends

- **尝试在WebSocket处理中忽略断开异常** — 忽略异常会导致无限循环或资源泄漏 (60% fail)
- **使用全局异常捕获所有异常** — WebSocketDisconnect是特定异常，全局捕获可能不处理 (40% fail)