如何在RSpec中为哈希数组结合使用eq与hash_including匹配器

问题场景 #

我有一个哈希数组，需要断言它满足三个核心要求：

• 元素数量精确：数组长度与预期完全一致
• 顺序严格匹配：元素的排列顺序和预期一致
• 元素包含指定键值：每个元素是包含指定键值对的哈希

示例数组如下：

fruits = [
  { name: 'apple', count: 3 },
  { name: 'orange', count: 14 },
  { name: 'strawberry', count: 7 },
]

尝试用eq匹配器结合hash_including时断言失败：

# 断言失败
expect(fruits).to eq([
  hash_including(name: 'apple'),
  hash_including(name: 'orange'),
  hash_including(name: 'strawberry'),
])

我排除了以下几种方案：

• 手动转换数据结构：虽可行，但违背匹配器设计初衷，降低用例可读性

  fruit_names = fruits.map { |h| h.fetch(:name) }
  expect(fruit_names).to eq(['apple', 'orange', 'strawberry'])
  

• include匹配器：仅校验元素存在，不保证数组长度和顺序

  # 断言通过，但不校验数组长度和元素顺序
  expect(fruits).include(
    hash_including(name: 'apple'),
    hash_including(name: 'orange'),
    hash_including(name: 'strawberry'),
  )
  

• contain_exactly匹配器：校验元素存在和数量，但不保证顺序

  # 断言通过，但不校验元素的精确顺序
  expect(fruits).contain_exactly(
    hash_including(name: 'apple'),
    hash_including(name: 'orange'),
    hash_including(name: 'strawberry'),
  )
  

正确解决方案 #

使用RSpec的match匹配器，它完美满足所有需求：

expect(fruits).to match([
  hash_including(name: 'apple'),
  hash_including(name: 'orange'),
  hash_including(name: 'strawberry'),
])

匹配逻辑说明 #

1. 顺序校验：match会按顺序比对实际数组与预期数组的每个元素，确保第n个实际元素匹配第n个预期匹配器
2. 长度校验：实际数组的长度必须和预期数组的长度完全一致，自动满足“特定数量”要求
3. 元素校验：hash_including负责校验每个哈希元素包含指定的键值对，忽略其他额外键（如示例中的count）

如果需要校验多个键值对，直接在hash_including中添加即可：

expect(fruits).to match([
  hash_including(name: 'apple', count: 3),
  hash_including(name: 'orange'),
  hash_including(name: 'strawberry', count: 7),
])

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