Rails5中如何在Rake任务调用迁移？自定义目录迁移报错怎么解决？

嘿，我来帮你搞定Rails 5里这个手动迁移的问题！你遇到的ActiveRecord::UnknownMigrationVersionError和migrations_paths失效的问题，其实是因为Rails 5对迁移系统做了一些调整——原来直接修改全局ActiveRecord::Migrator.migrations_paths的方式不再可靠，现在更推荐实例化Migrator对象或者通过环境变量指定路径。下面给你几个可行的解决方案：

解决方案1：手动实例化Migrator（最可靠） #

你可以在Rake任务里明确指定迁移目录，找到对应版本的迁移文件，再实例化Migrator执行操作。这样能完全隔离自定义迁移和系统默认迁移，避免冲突。

修改你的Rake任务代码如下：

desc 'Run db:migrate:up on a task we wish to migrate manually (e.g. not on all servers).'
task :manual_migrate, [:version] => :environment do |_t, args|
  # 先检查是否传入了版本号
  unless args.version.present?
    puts "请指定迁移版本号，比如：rake manual_migrate[20180209214145]"
    exit 1
  end

  # 定义自定义迁移目录
  custom_migration_paths = ['db/manual_migrate']
  target_version = args.version.to_i

  # 在指定目录里查找对应版本的迁移文件
  target_migration = ActiveRecord::Migrator.migrations(custom_migration_paths).detect do |migration|
    migration.version == target_version
  end

  # 如果找不到对应版本，抛出明确错误
  unless target_migration
    raise ActiveRecord::UnknownMigrationVersionError, "No migration with version number #{args.version}"
  end

  # 实例化Migrator并执行up操作
  migrator = ActiveRecord::Migrator.new(:up, custom_migration_paths, target_version)
  migrator.migrate

  puts "手动迁移 #{target_version} 执行成功！"
end

这段代码的核心优势：

• 明确限定迁移文件的查找范围，不会和默认的db/migrate目录混淆
• 提前校验版本号存在性，避免系统抛出模糊错误
• 完全遵循Rails 5迁移API规范，兼容性更强

解决方案2：复用Rails内置迁移任务（更简洁） #

如果你不想自己写太多逻辑，可以直接调用Rails内置的db:migrate:up任务，通过环境变量指定自定义迁移路径，这种方式更适合简单场景：

desc 'Run manual migration up'
task :manual_migrate_up, [:version] => :environment do |_t, args|
  unless args.version.present?
    puts "请指定迁移版本号，比如：rake manual_migrate_up[20180209214145]"
    exit 1
  end

  # 设置环境变量，告诉Rails使用自定义迁移目录
  ENV['MIGRATION_PATHS'] = 'db/manual_migrate'
  # 可选：如果需要单独维护自定义迁移的schema文件，可设置此变量
  ENV['SCHEMA'] = 'db/manual_schema.rb'

  # 调用内置的db:migrate:up任务
  Rake::Task['db:migrate:up'].invoke(args.version)
end

注意：如果你的Rake任务是批量执行的，执行完后建议重置环境变量，避免影响后续任务的执行。

排查报错的关键点 #

你遇到的ActiveRecord::UnknownMigrationVersionError，大概率是这几个原因：

• 自定义迁移目录db/manual_migrate里没有对应版本的文件，检查文件名是否符合20180209214145_xxx.rb的规范
• 版本号输入错误，比如多写/少写了数字
• 原来的全局migrations_paths设置未生效，导致Migrator仍在默认目录中查找迁移文件

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