# 类型错误：datetime 类型的对象不可 JSON 序列化

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

## 根因

FastAPI 路径操作返回了 Python datetime 对象，但 JSON 编码器无法处理

## 版本兼容性

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

## 解决方案

1. **使用 Pydantic 模型并定义字段类型** (95% 成功率)
   ```
   from pydantic import BaseModel
class Item(BaseModel):
    created_at: datetime
    class Config:
        json_encoders = {datetime: lambda v: v.isoformat()}
   ```
2. **在返回前手动转换** (90% 成功率)
   ```
   return {'created_at': datetime.now().isoformat()}
   ```

## 无效尝试

- **手动将 datetime 转为字符串但忽略时区** — 可能导致时区信息丢失 (60% 失败率)
- **使用 json.dumps 并设置默认参数** — FastAPI 使用自己的 JSON 编码器，自定义可能被覆盖 (70% 失败率)