如何在RSpec中统一管理复用的Discord客户端Mock对象？

你可以通过以下几种方式实现#mock_client方法的全局复用，按推荐优先级排序：

1. 放到RSpec Support目录（推荐） #

Rails的RSpec默认会自动加载spec/support目录下的所有文件，这是存放测试辅助方法的标准位置，便于统一维护。

步骤： #

• 在spec/support下创建新文件，比如discord_client_test_helpers.rb
• 把mock_client方法封装到模块中：

module DiscordClientTestHelpers
  def mock_client
    client = instance_double(DiscordClient)

    allow(DiscordClient).to receive(:new).and_return(client)
    allow(client).to receive(:get_guild)
    allow(client).to receive(:get_user)

    client
  end
end

• 在spec/rails_helper.rb（或spec_helper.rb）中把这个模块混入到所有RSpec示例组：

RSpec.configure do |config|
  config.include DiscordClientTestHelpers
end

之后在任意spec文件里，直接调用mock_client方法即可，无需重复定义。

2. 使用RSpec共享上下文 #

如果需要更灵活的控制（比如只在特定类型的测试中启用），可以定义共享上下文：

# spec/support/shared_discord_client_mocks.rb
RSpec.shared_context "with mocked Discord client" do
  let(:discord_client) { mock_client }

  def mock_client
    client = instance_double(DiscordClient)

    allow(DiscordClient).to receive(:new).and_return(client)
    allow(client).to receive(:get_guild)
    allow(client).to receive(:get_user)

    client
  end
end

在需要的spec文件中，通过include_context引入：

RSpec.describe SomeServiceClass do
  include_context "with mocked Discord client"

  describe '#call' do
    it 'uses Discord client correctly' do
      described_class.new.call
      
      expect(DiscordClient).to have_received(:new).once
      expect(discord_client).to have_received(:get_guild).once
    end
  end
end

3. 直接在RSpec配置中定义全局方法（不推荐） #

虽然可以直接在配置文件中定义全局方法，但会让配置文件臃肿，不利于后续维护：

# spec/rails_helper.rb
RSpec.configure do |config|
  config.define_derived_metadata do |meta|
    meta[:example_group].send(:define_method, :mock_client) do
      client = instance_double(DiscordClient)

      allow(DiscordClient).to receive(:new).and_return(client)
      allow(client).to receive(:get_guild)
      allow(client).to receive(:get_user)

      client
    end
  end
end

注意事项 #

• 确认spec/support目录下的文件能被正确加载，Rails默认已在rails_helper.rb中配置：Dir[Rails.root.join('spec', 'support', '**', '*.rb')].sort.each { |f| require f }
• 后续扩展mock逻辑（比如新增stub方法）时，只需修改support目录下的对应文件，所有使用该方法的测试会自动生效

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