Rails 測試全攻略：從單元、功能到集成測試的實戰指南

為什麼要寫測試？

• 重構安全網：確保代碼重構後功能不回歸。
• 模擬瀏覽器請求：無需啟動瀏覽器即可驗證 Controller 響應、重定向、模板渲染。
• 文檔化業務邏輯：測試代碼即活文檔，新人於閱讀測試理解需求。

測試環境三要素

1. 三環境隔離

config/database.yml 定義 development、test、production 三套數據庫配置，徹底隔離測試數據。

2. 測試數據庫準備

# 同步開發庫結構到測試庫
rake db:migrate
rake db:test:prepare  # 或 rake db:test:load

3. 目錄結構

test/
├── fixtures/        # 測試數據
├── unit/            # Model 單元測試
├── functional/      # Controller 功能測試
├── integration/     # 多 Controller 集成測試
├── performance/     # 性能測試
└── test_helper.rb   # 全局配置、輔助方法

Fixtures：聲明式測試數據

YAML 格式

# test/fixtures/users.yml
david:
  name: David Heinemeier Hansson
  birthday: 1979-10-15
  profession: Systems development

steve:
  name: Steve Ross Kellock
  birthday: 1974-09-27
  profession: Guy with keyboard

ERB 動態數據

<% earth_size = 20 %>
mercury:
  size: <%= earth_size / 50 %>
  brightest_on: <%= 113.days.ago.to_s(:db) %>
venus:
  size: <%= earth_size / 2 %>
  brightest_on: <%= 67.days.ago.to_s(:db) %>

使用方式

# 自動加載到同名變量
user = users(:david)
user.name  # => "David Heinemeier Hansson"

單元測試

生成與結構

# rails g model Post title:string content:text
# 生成 test/unit/post_test.rb
require 'test_helper'
class PostTest < ActiveSupport::TestCase
  test "the truth" do
    assert true
  end
end

• 繼承 ActiveSupport::TestCase。
• 方法名以 test_ 開頭自動識別為測試用例。

運行命令

# 單文件
ruby -Itest test/unit/post_test.rb
# 指定方法
ruby -Itest test/unit/post_test.rb -n test_the_truth
# Rake 任務
rake test TEST=test/unit/user_test.rb

功能測試

核心驗證點

• HTTP 響應碼（200/302/404/500）。
• 重定向目標（assert_redirected_to）。
• 認證授權（登入/未登入/權限不足）。
• 模板變量賦值（assigns(:post)）。
• 視圖內容（assert_select、assert_match）。

可用請求方法

get    :index
post   :create, params: { post: { title: "Test" } }
put    :update, params: { id: 1, post: { title: "Updated" } }
delete :destroy, params: { id: 1 }
head   :show, params: { id: 1 }

四大 Hash 輔助

• assigns：實例變量（@post）。
• cookies：Cookie 值。
• flash：Flash 消息。
• session：Session 數據。

實例變量

• @controller：當前 Controller 實例。
• @request：Request 對象。
• @response：Response 對象。

集成測試

適用場景

• 用戶完整業務流程（註冊 → 登入 → 發帖 → 評論 → 登出）。
• 跨多個 Controller 的交互驗證。
• API 端到端測試。

生成與示例

rails g integration_test user_flows
# test/integration/user_flows_test.rb
require 'test_helper'
class UserFlowsTest < ActionDispatch::IntegrationTest
  fixtures :all
  test "user registration and login flow" do
    # 訪問註冊頁
    get signup_path
    assert_response :success
    
    # 提交註冊
    post users_path, params: { user: { name: "Test", email: "test@example.com", password: "secret" } }
    assert_redirected_to root_path
    follow_redirect!
    assert_select "div.flash.notice", "Welcome!"
    
    # 登出
    delete logout_path
    assert_redirected_to login_path
  end
end

進階技巧

• 並行測試：parallelize(workers: :number_of_processors) 加速大型測試套件。
• 系統測試：Rails 5.1+ ActionDispatch::SystemTestCase 驅動真實瀏覽器（Chrome/Firefox Headless），測試 JavaScript 交互。
• 測試覆蓋率：SimpleCov 生成 HTML 報告，針對未覆蓋代碼補充用例。

總結

Rails 內建測試框架提供了從 Model 到 Controller 再到全鏈路的完整驗證能力。關鍵實踐：

1. Fixtures 管理測試數據，保持隔離與可重複性。
2. 單元測試覆蓋業務邏輯，功能測試驗證 HTTP 交互，集成測試串聯核心流程。
3. 持續集成強制運行測試，禁止跳過測試部署。

測試不是成本，是對未來維護性的投資。