概要

Railsのテストを実行した際に、Could not find table というエラーが起きる場合があります。

本記事では、このエラーがなぜ起きるのか、どう解決するのかを解説します。

この記事で伝えたいこと

Could not find tableのエラーが起きる理由
Could not find tablエラーを解決する方法

実行したテスト

ユーザインスタンスを作成し、ユーザが有効かどうか検証する。

class UserTest < ActiveSupport::TestCase

# 事前に、ユーザインスタンスに名前等の各値を設定する
# setupメソッドは、テスト実行時に自動で実行される
  def setup
    @user = User.new(name: "Emi", email: "emi@a.com", password: "fooooo", password_confirmation: "fooooo")
  end

  test "should be valid" do 
    assert @user.valid?
  end 
...
end

発生したエラー

テスト実行時に、テーブルが存在しないというエラーが発生します。

下記のActiveRecord::StatementInvalid とは、ActiveRecord（モデル）がデータベースにクエリ（命令）を実行した際に発生するエラーです。

Error:
UserTest#test_should_be_valid:
ActiveRecord::StatementInvalid: Could not find table 'tag_relations'

ActiveRecordとは
ビジネスデータ（データベースに保存される顧客情報等のデータ）と、ビジネスロジック（データをどう操作するかが書かれた処理）を操作する役割。
簡単に言うと、Modelとデータベースのやり取りがスムーズになるように、仲介する役割。

エラーが起きる原因

test_helper.rbでフィクスチャファイルを読み込む設定になっているのに、フィクスチャファイルで適切な設定がされていません。

以下の、 fixtures :all で、全てのフィクスチャファイルを読み込む設定になっています。

# test_helper.rb
module ActiveSupport
  class TestCase
	  ...
    # Setup all fixtures in test/fixtures/*.yml for all tests in alphabetical order.
    
    fixtures :all
		...
  end
end

test_helper.rbとは

テスト全体で使用したい設定を保存するファイル。

フィクスチャファイルとは

テストデータベース用のサンプルデータのことで。
フィクスチャを使用すると、事前に定義したデータを、テスト実行直前にテストデータベースに導入できます。

エラーを解決する方法

解決方法の種類

エラーを解決する方法として、以下の３つがあります。
今回のテストではデータベース内のデータが必要ないため、２のフィクスチャを無効化する方法を行います。

１．フィクスチャを設定する

事前にデータベースにデータが必要な場合(データの永続化が必要な場合)は、フィクスチャを使用。

２. フィクスチャを無効化する

データベースにデータが必要ない場合は、フィクスチャを無効化する。

３． FactoryBotを使用する

複数のモデルで関連づけや、attribute(型の変換や、デフォルト値を設定)が異なるデータを多く作成する場合に使用。

フィクスチャを使用すべきかの判断は、下記のサイトが参考になります。

Rails Fixtures再考

フィクスチャ無効化の方法

test_helper.rbをコメントアウトする。
フィクスチャの使用を無効化すると、フィクスチャのテストが通るようになります。

# test_helper.rb
module ActiveSupport
  class TestCase
	  ...
    # Setup all fixtures in test/fixtures/*.yml for all tests in alphabetical order.
    
    #fixtures :all
		...
  end
end

フィクスチャ無効化のデメリット

テスト実行時にデータベースにデータが必要な場合は、フィクスチャやFactoryBotを使用する必要があります。