# 断言错误：路径操作 'GET /items' 已经注册

- **ID:** `python/fastapi-path-operation-name-error`
- **领域:** python
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

FastAPI 中重复定义了相同的路由和 HTTP 方法。

## 版本兼容性

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

## 解决方案

1. **** (95% 成功率)
   ```
   确保路径和 HTTP 方法组合唯一
   ```
2. **** (90% 成功率)
   ```
   使用 APIRouter 组织路由并避免冲突
   ```
3. **** (85% 成功率)
   ```
   在添加路由前检查是否已存在
   ```

## 无效尝试

- **** — 路由冲突，请求可能被错误处理。 (80% 失败率)
- **** — FastAPI 检查路径和方法，不检查函数名。 (90% 失败率)
- **** — 仍然会注册多个操作。 (70% 失败率)