RSpec FactoryBot【入門編】：Railsテストデータ作成の基本と使い方

2025年4月21日

「RSpecのテストデータ準備、もっと楽にならないかな…」
「FactoryBotって便利そうだけど、何から始めればいいの？」

Rails開発でテストを書く際、多くの人がテストデータの準備に手間を感じています。そんな悩みを解決してくれるのが FactoryBot です。

FactoryBotは、RSpecテストで使うデータを簡単・効率的に作成するための定番ライブラリ。この記事では、FactoryBotを初めて使う方に向けて、その導入方法から基本的な使い方までを分かりやすく解説します。

この記事で学べること:

FactoryBotがなぜ便利なのか？
Railsプロジェクトへの導入と初期設定
create, build, attributes_for の基本的な使い方と違い
テストデータの「設計図」となるファクトリの簡単な作り方
Faker Gemを使ったリアルなダミーデータの生成
sequence を使った一意な値の作り方

この記事を読めば、あなたもFactoryBotの第一歩を踏み出し、テストデータ作成のストレスを減らすことができます。さっそく始めてみましょう！

FactoryBotとは？なぜ便利？

FactoryBotは、テストで使用するオブジェクト（モデルのインスタンスなど）を簡単に生成するためのRubyライブラリです。
手動で User.create(name: "...", email: "...") のように書く代わりに、事前に定義した「ファクトリ」を使って create(:user) のように簡潔に書けるようになります。

FactoryBotを使うメリット

効率的: テストデータの作成コードが短くなり、記述の手間が省けます。
DRY (Don’t Repeat Yourself): 同じようなデータ作成コードを何度も書く必要がなくなり、コードがすっきりします。
可読性向上: create(:admin_user) のように、どのようなデータを作成しているかが分かりやすくなります。
メンテナンス性向上: モデルの属性変更時などに、修正箇所がファクトリ定義に集約されるため、修正が容易になります。

テストを書く上で非常に強力なツールですので、ぜひ使い方をマスターしましょう。

FactoryBotをRailsプロジェクトに導入する

それでは、実際にFactoryBotを導入してみましょう。

1. Gemのインストール:

Gemfile の :development, :test グループに factory_bot_rails を追加します。リアルなデータ生成に便利な faker も一緒に追加するのがおすすめです。

# Gemfile
group :development, :test do
  gem 'rspec-rails' # ご自身の環境に合わせてください
  gem 'factory_bot_rails'
  gem 'faker' # リアルなダミーデータ生成に便利
end

ターミナルで bundle install を実行して、Gemをインストールします。

bundle install

2. RSpecの設定:

テストコード (spec/ ディレクトリ以下) で create や build といったFactoryBotのメソッドを直接呼び出せるように設定します。

spec/support/factory_bot.rb というファイルを作成し、以下の内容を記述してください。 (spec/support ディレクトリがない場合は作成してください)

# spec/support/factory_bot.rb
RSpec.configure do |config|
  config.include FactoryBot::Syntax::Methods
end

通常、spec/rails_helper.rb で spec/support ディレクトリ内のファイルが自動的に読み込まれます。もし読み込まれない設定になっている場合は、spec/rails_helper.rb を確認してください。

これでFactoryBotを使う準備が整いました！

基本的な使い方：3つの主要メソッドを覚えよう

FactoryBotには、テストデータを作成するための主要なメソッドが3つあります。まずはこれらの違いと使い方を覚えましょう。

create

データベースにレコードを保存して、そのオブジェクトを返します。

DBにデータが存在することが前提となるテストで使います。

一番よく使うメソッドです。

user = create(:user)

puts user.id         # => 1 (例)
puts user.persisted? # => true (DBに保存されている)

build

オブジェクトをメモリ上に作成しますが、データベースには保存しません。

User.new(...) のようなイメージです。

モデルのバリデーションチェックなど、DB保存が不要なテストで使うとテストが速くなります。

user = build(:user)

puts user.id         # => nil (DBに保存されていないためIDがない)
puts user.persisted? # => false (DBに保存されていない)

attributes_for

オブジェクトは作らず、ファクトリで定義された属性とその値のハッシュを返します。

コントローラーテストでフォームから送られるようなリクエストパラメータを作るのに便利です。

user_params = attributes_for(:user)

puts user_params
# => {:name=>"テスト 太郎", :email=>"test1@example.com", :password=>"password"} (例)

使い分けのポイント
テストの目的を考え、「DBへの保存が必要か？」を基準に create と build を使い分けるのが基本です。パラメータのハッシュだけが必要なら attributes_for を使いましょう。

ファクトリ定義：テストデータの「設計図」を作る

create(:user) のようにファクトリを呼び出すには、事前に :user ファクトリがどのようなデータを作るかの「設計図」を定義しておく必要があります。

ファクトリファイルの場所:
通常、spec/factories/ ディレクトリの中に、モデル名の複数形に対応するファイル名で作成します。例えば User モデルなら spec/factories/users.rb です。

基本的な定義方法:
FactoryBot.define ブロックの中に factory メソッドを使って定義します。

# spec/factories/users.rb
FactoryBot.define do
  factory :user do
    name { "テスト 太郎" }
    email { "test@example.com" }
    sequence(:email) { |n| "test#{n}@example.com" }
    password { "password" }
    password_confirmation { "password" }
  end
end

factory :user do ... end: :user という名前（シンボル）でファクトリを定義します。通常、モデル名の小文字を使います。
属性名 { 値 }: 各属性のデフォルト値を {} ブロックで囲んで指定します。ブロックで囲むことで、ファクトリが呼び出されるたびに評価され、動的な値を設定できます。

これで create(:user) や build(:user) が使えるようになりました。

Faker Gemでリアルなテストデータを作る

"テスト太郎" のような固定値ではなく、もっと本物らしいデータを使いたいですよね。そこで活躍するのが Faker Gemです（導入時に Gemfile に追加しました）。

Fakerを使うと、名前、メールアドレス、住所、文章など、様々な種類のリアルなダミーデータを簡単に生成できます。

# spec/factories/users.rb
FactoryBot.define do
  factory :user do
    # Fakerを使ってランダムな名前を生成
    name { Faker::Name.name }

    # Fakerを使ってランダムなメールアドレスを生成 (sequenceと組み合わせる)
    sequence(:email) { |n| "#{n}_#{Faker::Internet.email}" }

    password { "password" }
  end
end

# spec/factories/posts.rb (Postモデルがあると仮定)
FactoryBot.define do
  factory :post do
    # Fakerを使ってランダムな文章(3単語)を生成
    title { Faker::Lorem.sentence(word_count: 3) }
    # Fakerを使ってランダムな段落を生成
    content { Faker::Lorem.paragraph }

    # 関連付け (応用編で解説)
    # user
  end
end

Fakerには非常に多くのデータ生成メソッドがあります。公式ドキュメントを見て、使えそうなものを探してみましょう。

シーケンスで一意な値を生成する

メールアドレスのように、データベース上で一意である必要がある属性（ユニーク制約）を持つデータを複数作成する場合、同じ値だとエラーになります。

sequence を使うと、ファクトリが呼び出されるたびに連番を生成し、それを利用して一意な値を作ることができます。

# spec/factories/users.rb
FactoryBot.define do
  factory :user do
    name { Faker::Name.name }

    # ブロック引数 n には 1, 2, 3... と連番が入る
    sequence(:email) { |n| "unique_user_#{n}@example.com" }

    password { "password" }
  end
end

呼び出し例:

user1 = create(:user) # email は "unique_user_1@example.com"
user2 = create(:user) # email は "unique_user_2@example.com"

これで、create(:user) を複数回呼び出しても、メールアドレスが重複する心配がなくなります。

まとめ：最初のステップは完了！

この記事では、FactoryBotの導入から基本的な使い方、簡単なファクトリ定義、Fakerやシーケンスを使ったデータ生成までを解説しました。

今回のポイント:

FactoryBotはテストデータ作成を楽にするツール
create (DB保存), build (メモリのみ), attributes_for (ハッシュ) を使い分ける
spec/factories/ 以下にファクトリを定義する
Fakerでリアルなデータを、Sequenceで一意な値を作る

まずはここまでをマスターすれば、基本的なテストデータ作成はかなり効率化できるはずです。

次のステップ:
FactoryBotには、モデル間の関連付けの扱い、Traitを使った柔軟なデータ生成、コールバックによる追加処理など、さらに便利な機能がたくさんあります。

これらを使いこなしたい方は、ぜひ次の【応用編】の記事に進んでみてください！ (応用編へのリンクをここに貼る)

未経験からエンジニアへ転職！おすすめの転職サービスはこちら

「未経験だけどエンジニアになりたい…」「IT業界に興味があるけど、どこから始めるべきかわからない…」
そんな方におすすめなのが、プログラミングスクールを活用した転職活動です。
実績豊富なスクールを利用すれば、未経験からでもエンジニアとしての転職がぐっと近づきます！

Harmonia

初心者向けプログラミングスクールおすすめを徹底比較！初心者が安心して学べるおすすめのプログラミングスクールを厳選紹介！料金や口コミ、転職支援などを徹底比較しました。失敗しないスクール選びのポイントも解説。

この記事が気に入ったら
フォローしてね！

Follow @blue3orz Follow Me

よかったらシェアしてね！

URLをコピーしました！

URLをコピーしました！