# TypeError: 类型为 UUID 的对象无法 JSON 序列化

- **ID:** `python/fastapi-json-encoding-error`
- **领域:** python
- **类别:** type_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

FastAPI 的默认 JSON 编码器无法处理响应中的 UUID 对象。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.x | active | — | — |

## 解决方案

1. **** (90% 成功率)
   ```
   Use jsonable_encoder: from fastapi.encoders import jsonable_encoder; return jsonable_encoder(data)
   ```
2. **** (85% 成功率)
   ```
   Define a custom response class that handles UUIDs: class UUIDModel(BaseModel): id: UUID
   ```

## 无效尝试

- **** — This is repetitive and error-prone if missed in some places. (60% 失败率)
- **** — If imported incorrectly, it may not convert UUIDs. (50% 失败率)