RSpec any_args匹配器因参数数量错误报错的问题排查

为解决代码库中大量测试用例依赖MetricsClass.increment的具体调用（导致新增指标调用时测试极易失败），我在spec_helper.rb中添加了全局mock：

allow(MetricsClass).to receive(:increment).with(any_args)

但运行测试时触发错误：

ArgumentError:
  Wrong number of arguments. Expected 1, got 2.

相关代码与环境信息：

• MetricsClass.increment的方法定义：

def self.increment(counter_name, by: 1, **tags)

• 报错触发的调用代码：

MetricsClass.increment("string", **info)

其中info为哈希：{"class/method"=>true}

• 环境：Ruby 2.7.6，RSpec 3.12.0
• RSpec核心配置：

RSpec.configure do |config|
  config.mock_with :rspec do |mocks|
     mocks.verify_partial_doubles = true
  end
end

原因分析 #

开启verify_partial_doubles后，RSpec会严格校验mock方法的调用是否匹配真实方法的参数签名。with(any_args)会被RSpec解析为匹配任意数量的位置参数，但真实方法的参数结构是「1个必填位置参数 + 可选关键字参数 + 任意额外关键字参数」。当代码中通过**info传递关键字参数时，RSpec会误判参数数量不匹配，从而抛出错误。

修复方案 #

直接移除with(any_args)条件，改为全局mock该方法：

allow(MetricsClass).to receive(:increment)

这样RSpec会允许所有符合真实方法参数签名的调用，既满足全局mock的需求，又不会触发参数校验错误。

如果需要更精确的参数匹配（比如明确允许任意位置参数+任意关键字参数），也可以使用：

allow(MetricsClass).to receive(:increment).with(anything, any_keyword_args)

anything匹配任意位置参数值，any_keyword_args匹配0个或多个关键字参数，完全贴合真实方法的参数结构。

内容的提问来源于stack exchange，提问作者Malcolm O'Hare