Python操作MySQL创建索引时重复键名错误排查

可能的原因 #

• 并发竞态条件：如果你的Python代码是多线程/多进程运行，哪怕用了UUID，也可能出现：
  • 线程A还没完成索引删除，线程B就发起了同名索引的创建请求；
  • 全局变量或共享状态被多线程篡改，导致重复生成同一个索引名（比如UUID生成逻辑被意外复用）。
• 索引删除未执行/失败：代码逻辑漏洞导致删除索引的步骤没触发：
  • 查询执行出错时，直接进入异常分支，跳过了DROP INDEX操作；
  • 删除索引的语句本身执行失败（比如权限问题），但未捕获异常，导致索引残留。
• MySQL元数据不一致：极少情况下，MySQL的information_schema元数据缓存延迟，导致刚删除的索引在元数据中还能被查到，或者反之——误以为索引不存在而重复创建。
• UUID生成逻辑缺陷：如果你的UUID生成不是每次创建索引都重新生成（比如在循环外提前生成了一次，循环内重复使用），会导致索引名完全重复。

排查与修复步骤 #

1. 添加详细日志：
   每次执行CREATE INDEX和DROP INDEX时，记录索引名、当前时间戳、线程ID/进程ID，出错时直接定位是否有重复创建请求，或删除步骤是否遗漏。
2. 强制原子性操作：
   • 多线程/进程场景下，给表级操作加锁（比如Python的threading.Lock），确保同一时间只有一个线程在操作某张表的索引；
   • 用finally块包裹删除索引逻辑，无论查询成功/失败都执行删除：

     try:
         # 创建索引
         cursor.execute(f"CREATE INDEX {index_name} ON {table}({field}) USING {index_type}")
         # 执行查询并计时
         run_query(cursor, query)
     finally:
         # 确保删除索引，忽略不存在的错误
         cursor.execute(f"DROP INDEX IF EXISTS {index_name} ON {table}")
     

3. 创建前校验索引存在性：
   执行CREATE INDEX前，先查询MySQL元数据确认索引不存在：

   SELECT COUNT(*) FROM information_schema.STATISTICS 
   WHERE table_schema = '你的数据库名' 
     AND table_name = '你的表名' 
     AND index_name = '{index_name}'
   

   只有返回0时才执行创建操作。
4. 验证UUID生成逻辑：
   检查代码中UUID是否每次创建索引都重新生成，比如：
   • 错误示例：循环外生成一次UUID，循环内重复使用；
   • 正确示例：每次进入创建索引的分支时，调用uuid.uuid4().hex生成新的唯一名称。
5. 排查事务影响：
   MySQL的DDL语句（CREATE/DROP INDEX）会自动提交事务，避免手动开启事务后执行DDL，否则可能导致元数据同步异常。

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