マイグレーションのロールバックが出来ない時の対処方法（UnknownMigrationVersionError）

はじめに

rails db:rollbackでマイグレーションファイルをロールバックしようとしたところ、下記のようにUnknownMigrationVersionErrorというエラーに悩まされたので、この解決方法について書こうと思います。

ターミナル

rails aborted!
ActiveRecord::UnknownMigrationVersionError: 

No migration with version number 20201230115014.

UnknownMigrationVersionErrorの詳細

rails db:migrateでマイグレーションファイルの状態を確認したところ、NO FILEと書かれた身に覚えのないデータが残っていました。
これは、ステータスがupのままVSコード上でマイグレーションファイルを削除してしまったため、DB上にはデータが残っている状態でした。（おそらく、ActiveHashでモデルを作成した時に、skip-migrationを忘れて謝って作成したファイルだと思います...）
まとめると、対応するファイルが存在しないマイグレーションデータが残ったままになっていたのが、UnknownMigrationVersionErrorの原因でした。

解決方法

1. VSコード上にマイグレーションファイルを作成

まず、NO FILEとなっていたIDが20201230115014のデータに対応するファイルを、VSコード上で作成します。（今回は、「20201230115014.dummy.rb」というファイル名で作成しています。）

2. ステータスをdownにする

マイグレーションファイルを作成しただけの状態で、ロールバックしようとすると下記のようにエラーが出ます。これは、先ほど作成したマイグレーションファイルの中身が何も記述されていないことが原因です。

ターミナル

rails aborted!
NameError: uninitialized constant Dummy

これを解消するために、マイグレーションファイル内にクラスとchangeアクションを記述します。その後、一度マイグレートを行います。

20201230115014.dummy.rb

class Dummy < ActiveRecord::Migration[6.0]
  def change
  end
end

ターミナル

rails db:migrate

この状態で、ロールバックしてあげると、無事ステータスがダウンになりました。

3. 対象ファイルの削除

ここまで来れば、後は対象ファイルを削除するだけです。VSコードで「20201230115014.dummy.rb」のファイルを削除した後、rails db:migrate:statusで確認すると、無事対象のデータが削除できてることが確認できます。

終わりに

何気なく、ステータスを確認せずにマイグレーションファイルを削除すると後々面倒だなと思いました。何か見てくださる方のヒントになれば幸いです。

参考