# Alembic 命令错误：给定的参数链存在多个头版本，请指定具体的目标版本。

- **ID:** `python/sqlalchemy-multiple-heads-migration`
- **领域:** python
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

数据库迁移脚本中出现了多个分支头，Alembic 无法自动选择升级路径。

## 版本兼容性

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

## 解决方案

1. **** (90% 成功率)
   ```
   使用 alembic merge -m 'merge heads' 合并多个头，生成一个合并迁移。
   ```
2. **** (70% 成功率)
   ```
   指定具体的升级目标，例如：alembic upgrade <revision>
   ```

## 无效尝试

- **** — 手动删除某个迁移文件，但会导致版本历史不完整，其他开发者的环境无法同步。 (60% 失败率)
- **** — 尝试直接修改 alembic_version 表，但可能造成与迁移脚本不一致。 (80% 失败率)