Rails 8.0 中如何从头运行数据库迁移

在 Rails 8.0 版本中，数据库迁移的行为发生了一个重要变化：rails db:migrate 命令现在会隐式加载 db/schema.rb 文件。这一改动虽然对日常开发有益，但在某些特定场景下可能会带来不便，特别是在需要从头运行所有迁移的情况下。

问题背景

在持续集成(CI)环境中，一个常见的需求是验证 db/schema.rb 文件的正确性。通常的做法是创建一个全新的数据库，然后运行所有迁移，最后检查生成的 db/schema.rb 是否与代码库中的版本一致。在 Rails 8.0 之前，这可以通过简单的 rails db:create db:migrate 命令组合实现。

然而，Rails 8.0 的新行为意味着 db:migrate 会先加载现有的 db/schema.rb 文件，这实际上破坏了从头运行迁移的预期效果。

解决方案

方法一：删除 schema.rb 文件

最直接的解决方案是在运行迁移前删除 db/schema.rb 文件：

rm db/schema.rb
rails db:create db:migrate

这种方法简单有效，适用于大多数场景。它强制 Rails 完全依赖迁移文件来重建数据库结构。

方法二：使用 db:migrate:reset 命令

Rails 实际上提供了一个专门用于重置数据库并重新运行所有迁移的命令：

rails db:migrate:reset

这个命令会：

1. 删除现有数据库
2. 创建新的数据库
3. 运行所有迁移文件

相比手动删除 schema.rb 文件，这是更符合 Rails 惯例的做法。不过需要注意的是，这个命令不会出现在 rails -T 列出的任务列表中，也不在官方文档中有详细说明。

方法三：使用 db:migrate:redo 命令

对于开发环境中需要频繁修改表结构的情况，Rails 还提供了 db:migrate:redo 命令。这个命令可以回滚并重新运行迁移：

rails db:migrate:redo STEP=-1

这里的 STEP=-1 参数确保回滚并重新运行所有迁移。这在开发初期特别有用，当你可能频繁修改表结构而无需编写大量迁移文件时。

技术细节

在底层，Rails 8.0 的 db:migrate 任务现在会调用 ActiveRecord::Tasks::DatabaseTasks.migrate 方法，并默认加载 schema 文件。如果你需要直接通过 API 控制这一行为，可以传递 skip_initialize: true 参数来跳过 schema 文件的加载。

最佳实践建议

1. 在 CI 环境中验证 schema 文件时，优先使用 db:migrate:reset 命令
2. 在开发环境中频繁修改表结构时，考虑使用 db:migrate:redo 命令
3. 对于复杂的多数据库场景，可能需要结合使用这些方法或编写自定义任务

Rails 8.0 的这一变化实际上是为了更好地支持开发者的日常工作流，但在特定场景下需要开发者了解这些替代方案。理解这些命令的差异和适用场景将帮助你更高效地管理数据库迁移。