Ecto迁移：重命名表后索引名称问题及处理方案咨询

这个问题我之前帮朋友处理过，确实和Rails 3的思路很像，但得用Ecto的迁移语法来落地才行！直接说结论：推荐遵循「删除旧索引 → 重命名表 → 重建新索引」的流程，原因和具体操作如下：

为什么不能直接重命名表？ #

Ecto在执行表重命名时，只会修改表的名称，不会自动更新依附在表上的索引名称。比如原来users表上的index_users_on_email索引，表改成customers后，索引还是叫这个名字——虽然功能上没问题，但会导致两个麻烦：

• 索引名称和表名不匹配，后续维护时容易混淆
• 如果之后你用Ecto自动生成索引名的方式创建新索引（不指定name参数），可能会因为逻辑上的名称冲突引发困惑，甚至重复创建索引浪费资源

具体迁移步骤（附代码示例） #

下面是一个完整的迁移示例，假设要把users表重命名为customers：

defmodule MyApp.Repo.Migrations.RenameUsersToCustomers do
  use Ecto.Migration

  def up do
    # 1. 先删除旧表上的所有索引
    drop index(:users, [:email], unique: true)
    drop index(:users, [:username])

    # 2. 执行表重命名
    rename table(:users), to: table(:customers)

    # 3. 在新表上重建索引，名称会自动匹配新表名
    create index(:customers, [:email], unique: true)
    create index(:customers, [:username])
  end

  def down do
    # 回滚操作也要对应反向流程
    drop index(:customers, [:email], unique: true)
    drop index(:customers, [:username])

    rename table(:customers), to: table(:users)

    create index(:users, [:email], unique: true)
    create index(:users, [:username])
  end
end

可选：用原生SQL重命名索引（不推荐跨数据库场景） #

如果你的项目只依赖单一数据库（比如PostgreSQL），也可以选择直接重命名索引而不是删了重建，这样效率更高。比如PostgreSQL里可以用原生SQL：

def up do
    rename table(:users), to: table(:customers)
    execute "ALTER INDEX index_users_on_email RENAME TO index_customers_on_email;"
    execute "ALTER INDEX index_users_on_username RENAME TO index_customers_on_username;"
end

但这种方式的缺点是不跨数据库兼容，如果之后切换数据库（比如从PostgreSQL到MySQL），迁移代码就得修改，所以还是更推荐先删后建的通用方案。

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