RSpec模拟Pundit类时校验实例方法调用报错 寻求合规实现方案

在基于Pundit的权限策略开发测试中，需要验证两个核心逻辑：

• 目标策略类被业务流程正确实例化
• 实例化生成的策略对象，确实在后续流程中调用了指定的权限校验方法（如show?）

测试过程中尝试通过包装类的new方法实现监听，多次尝试均触发报错：

RSpec::Mocks::VerifyingMessageExpectation:0x0055e9ffd0b530 未定义方法 show?

已知可以通过expect_any_instance_of实现需求，但该方式被公认为代码异味，需要找更符合RSpec规范的实现方案。

之前的写法存在返回值逻辑错误：
在and_wrap_original的代码块中，最后一行书写的是expect(实例) to receive(...)语句，该语句的返回值是RSpec内部的VerifyingMessageExpectation类型对象。根据Ruby代码块的返回值规则，最后一行表达式的结果就是块的返回值，因此and_wrap_original会把这个内部对象作为new方法的返回值，替换掉本该返回的真实策略实例。
后续业务流程拿到的根本不是可用的策略对象，而是这个用于校验的内部期待对象，自然不存在show?方法，因此触发未定义方法的报错。

方案1：固定实例引用法（无第三方依赖，兼容所有RSpec版本） #

核心思路：拆分监听和校验的执行时机，避免在new方法的包装块内直接返回expect对象。

1. 在测试用例顶层定义变量，承接new方法生成的真实实例
2. 给类的new方法打包装监听，将生成的真实实例赋值给提前定义的变量
3. 触发完业务流程后，再对存储的真实实例做方法调用校验

示例代码：

# 顶层定义变量承接生成的策略实例
policy_instance = nil

# 监听new方法的调用，不直接在块内返回expect对象
expect(MyPolicy).to receive(:new).with(user, record) do |*args|
  # 调用原有构造逻辑生成真实实例，赋值给外层变量
  policy_instance = MyPolicy.allocate.tap { |obj| obj.send(:initialize, *args) }
end

# 触发待测试的业务流程（如调用控制器动作、执行Pundit权限校验流程）
get :show, params: { id: record.id }

# 流程执行完毕后，统一校验方法调用情况
expect(policy_instance).to have_received(:show?).and_call_original

方案2：实例替身法（接口安全，适配Pundit开发场景） #

核心思路：使用instance_double生成和真实策略类接口完全匹配的测试替身，提前指定替身的方法行为，再让类的new方法返回这个替身，从根源上避免实例生成的返回值错乱。
示例代码：

# 生成和MyPolicy接口一致的测试替身，若写错方法名会提前触发类型校验报错
test_policy = instance_double(MyPolicy)
# 给替身绑定show?方法的原有实现
allow(test_policy).to receive(:show?).and_call_original

# 监听类的new方法，校验实例化的参数正确性，直接返回我们准备好的替身
expect(MyPolicy).to receive(:new).with(user, record).and_return(test_policy)

# 触发待测试的业务流程
get :show, params: { id: record.id }

# 校验替身确实收到了目标方法的调用
expect(test_policy).to have_received(:show?)

对比expect_any_instance_of的实现方式：

• 作用域可控，仅对本次测试中预期生成的单实例做校验，不会全局拦截所有可能生成的同类实例
• 无测试副作用，不会干扰测试流程中其他分支生成的实例的正常行为
• 报错提示精准，若实例化参数错误、方法名拼写错误，会在对应校验点直接抛出明确提示，不会出现模糊的全局匹配问题

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