Rails中Cucumber测试预期失败却通过的问题排查

问题场景 #

我为基础Rails应用编写了一组简单的Cucumber测试，逻辑是访问静态页面并检查页面是否存在特定文本，但页面中并不包含目标文本，测试却意外通过了。

测试场景 #

Scenario: Visit the About screen
  Given I am on the About page
  Then I should see "Version"

步骤定义 #

Given 'I am on the About page' do
  visit "/about"
end

Then 'I should see {string}' do |page_text|
  page.has_text?(page_text)
end

对应的about.html.erb页面内容 #

<h1>StaticPages#about</h1>
<p>Find me in app/views/static_pages/about.html.erb</p>

核心原因 #

问题出在Then步骤的定义逻辑：page.has_text?(page_text)仅返回布尔值，但Cucumber的Then步骤需要主动触发断言失败。如果只是返回false而不抛出异常，Cucumber会默认认为步骤执行成功，导致测试错误通过。

正确的写法应该使用断言库抛出异常，比如用RSpec断言：

Then 'I should see {string}' do |page_text|
  expect(page).to have_text(page_text)
end

或者Minitest断言：

Then 'I should see {string}' do |page_text|
  assert page.has_text?(page_text)
end

排查与调试方法 #

• 检查断言逻辑：首先确认Then步骤是否使用了断言方法，而非仅返回布尔值。这是此类问题最常见的根源。
• 添加调试输出：在步骤定义中打印关键信息，验证实际执行结果：

  Then 'I should see {string}' do |page_text|
    puts "页面内容：\n#{page.body}"
    result = page.has_text?(page_text)
    puts "检查「#{page_text}」的结果：#{result}"
    result
  end
  

  运行测试后，通过输出可以确认页面实际内容和检查结果，判断是否真的未匹配到文本。
• 验证页面加载正确性：使用save_and_open_page（需安装launchy gem）在Given步骤后打开实际加载的页面，确认是否访问了正确的/about页面，排查路由或缓存导致的页面加载错误。
• 检查步骤匹配情况：确认场景中的步骤文本与步骤定义的字符串/正则完全匹配，避免因拼写错误导致步骤未被正确执行。
• 排查全局内容影响：检查应用的布局文件（如application.html.erb）是否包含目标文本，可能全局布局中的内容被忽略，导致测试误判。

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