使用AlterField执行migrate时出现Duplicate key name错误的原因

为什么AlterField会触发重复索引错误？ #

你遇到的问题本质是：Django执行AlterField给字段添加索引时，发现数据库中已经存在同名索引，所以抛出重复键名的错误。

具体来说：

• 你的historicalglobalparam表是Django Simple History生成的历史表，这个表的history_date字段默认就会被Simple History自动添加索引。
• 你在迁移文件里用AlterField给这个字段加上db_index=True，Django会尝试创建新的索引，但实际上该索引已经存在于数据库中，因此触发了MySQL的"Duplicate key name"错误。
• 另外也可能是之前的迁移操作已经创建过这个索引，但迁移文件的记录出现异常，导致Django误以为需要重复创建。

解决步骤 #

1. 确认索引状态
   执行SQL命令查看目标表的索引：

   SHOW INDEX FROM shared_models_historicalglobalparam;
   

   检查是否存在名为shared_models_historicalglobalparam_history_date_26e0c543的索引，且关联字段是history_date。

2. 移除多余的迁移代码
   如果索引已经存在，说明这个AlterField操作完全多余，直接从迁移文件中删除这段代码：

   migrations.AlterField(
       model_name='historicalglobalparam',
       name='history_date',
       field=models.DateTimeField(db_index=True),
   ),
   

   之后重新执行迁移命令：

   python manage.py migrate
   

3. 特殊情况处理（若需修改索引）
   如果确实需要调整该字段的索引（比如更换索引类型），可以修改迁移文件，先用RemoveIndex删除旧索引，再用AddIndex添加新索引：

   migrations.RemoveIndex(
       model_name='historicalglobalparam',
       name='shared_models_historicalglobalparam_history_date_26e0c543',
   ),
   migrations.AddIndex(
       model_name='historicalglobalparam',
       index=models.Index(fields=['history_date'], name='new_custom_index_name'),
   ),
   

   注意替换new_custom_index_name为你想要的新索引名，再执行迁移。

内容的提问来源于stack exchange，提问作者whitebear