适配新版Rails：无Rails环境运行ActiveRecord 5+迁移报错求助

咱们先理清楚报错的根源：从ActiveRecord 5开始，官方移除了ActiveRecord::Migrator.up这个类方法，迁移器的API做了不小的重构，原来的调用方式自然就失效了。下面给你一步步的解决思路和代码示例：

1. 先确认ActiveRecord的基础配置（无Rails依赖时必须手动做） #

在跑迁移之前，得先手动初始化ActiveRecord的数据库连接，不然迁移器根本不知道连哪个库。示例代码大概是这样：

require 'active_record'

# 配置数据库连接，根据你的数据库类型调整（比如mysql/postgresql/sqlite）
ActiveRecord::Base.establish_connection(
  adapter: 'sqlite3',
  database: ':memory:' # 或者你的实际数据库路径
)

# 确保schema_migrations表存在（如果还没创建的话）
ActiveRecord::Schema.define do
  create_table :schema_migrations, id: false do |t|
    t.string :version, null: false
  end
  add_index :schema_migrations, :version, unique: true
end unless ActiveRecord::Base.connection.table_exists?(:schema_migrations)

2. 替换旧的Migrator.up调用，改用AR5+的API #

现在有两种常用的方式来执行迁移：

方式一：使用ActiveRecord::MigrationContext（推荐，官方更推荐的方式） #

这个类是AR5新增的，专门用来处理迁移上下文，代码示例：

# 指定迁移文件的路径，比如你的迁移文件在db/migrations下
migration_path = File.expand_path('../db/migrations', __dir__)
context = ActiveRecord::MigrationContext.new(migration_path, ActiveRecord::SchemaMigration)

# 执行所有未运行的迁移（对应原来的up）
context.migrate

# 如果只想执行到某个特定版本，可以传版本号
# context.migrate(20240520123456)

方式二：直接实例化ActiveRecord::Migrator #

如果你更贴近原来的写法，也可以手动实例化Migrator，不过要注意参数的变化：

migration_path = File.expand_path('../db/migrations', __dir__)
target_version = nil # nil表示执行所有未完成的迁移
migrator = ActiveRecord::Migrator.new(:up, migration_path, target_version)

# 执行迁移
migrator.migrate

3. 验证迁移是否正常运行 #

可以加一段代码来检查迁移状态，确保所有迁移都执行成功：

# 查看已运行的迁移版本
puts "已执行的迁移版本：#{ActiveRecord::SchemaMigration.pluck(:version).join(', ')}"
# 查看待执行的迁移
pending_migrations = context.pending_migrations
puts "待执行的迁移：#{pending_migrations.map(&:version).join(', ')}" if pending_migrations.any?

一些注意事项 #

• 如果你用的是AR6+，还要注意schema_format的配置，默认是:ruby，如果你的schema是sql格式，需要手动设置ActiveRecord::Base.schema_format = :sql
• 确保迁移文件的命名符合AR的规范（YYYYMMDDHHMMSS_migration_name.rb），不然迁移器识别不到
• 如果你的迁移里用到了Rails特有的方法（比如rails generate生成的一些辅助方法），可能需要单独引入对应的模块，比如require 'active_record/railties/databases'，不过尽量保持迁移的独立性更好

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