无需Rails的RSpec迷你Mock服务器：API客户端端到端测试方案咨询

完全可以通过Rack或Sinatra实现你想要的这类测试方案，而且这是Ruby社区非常成熟的实践，比直接Mock HTTP客户端的方案更贴近真实调用场景。 #

轻量实现方案（纯Rack，无额外依赖） #

你可以自己封装一个极简的MockServer类，核心逻辑就是在测试运行时启动一个监听随机端口的临时Rack服务，捕获所有请求数据，测试执行完成后自动销毁服务，完全匹配你给出的用法示例。

你可以把下面的代码放到spec/support/mock_server.rb中直接使用：

require 'rack'
require 'webrick'
require 'ostruct'

class MockServer
  attr_reader :url, :last_request

  def initialize
    # 定义Rack应用，捕获所有请求
    rack_app = ->(env) do
      req = Rack::Request.new(env)
      # 格式化请求头，把HTTP_X_WHATTY_WHAT转成标准的X-Whatty-What格式
      headers = env.each_with_object({}) do |(key, value), hash|
        next unless key.start_with?('HTTP_')
        header_name = key.delete_prefix('HTTP_').split('_').map(&:capitalize).join('-')
        hash[header_name] = value
      end
      # 存储请求数据供断言用
      @last_request = OpenStruct.new(
        params: req.params.transform_keys(&:to_sym),
        headers: headers,
        body: req.body.read,
        method: req.request_method,
        path: req.path
      )
      # 默认返回200响应，你可以根据需要自定义返回逻辑
      [200, {'Content-Type' => 'application/json'}, ['{"code":0}']]
    end

    # 启动临时WEBrick服务，用随机端口避免冲突
    @server = WEBrick::HTTPServer.new(
      Port: 0,
      AccessLog: [], # 关闭访问日志避免测试输出杂乱
      Logger: WEBrick::Log.new(File::NULL) # 关闭服务日志
    )
    @server.mount '/', Rack::Handler::WEBrick, rack_app
    @url = "http://localhost:#{@server.config[:Port]}"

    # 后台启动服务
    Thread.new { @server.start }
    # 等待服务启动完成
    sleep 0.1

    yield self if block_given?
  ensure
    # 测试完成自动关闭服务，避免残留进程占用端口
    @server&.shutdown
  end
end

这个实现可以直接适配你给出的测试代码，不需要修改任何用法。 #

复杂场景适配（Sinatra） #

如果你需要模拟更复杂的接口逻辑，比如不同路径返回不同响应、根据请求参数动态返回内容、模拟异常状态码等，可以把上面的Rack应用替换为Sinatra应用，路由定义会更简洁直观，实现思路和纯Rack版本完全一致。 #

实践优势 #

这种本地临时服务的测试方案相比Mock Typhoeus的方案有几个明显的优势：

• 不绑定特定HTTP客户端，不管你后续用Typhoeus、Faraday还是原生Net::HTTP，测试逻辑都不需要修改
• 可以覆盖到HTTP客户端本身的配置问题，比如代理设置、SSL校验、参数序列化逻辑、头拼接规则等，这些是直接Mock客户端无法覆盖的场景
• 更贴近真实端到端测试的逻辑，测试可信度更高

唯一的缺点是每个测试会多几毫秒的服务启动耗时，对于普通测试套件完全可以忽略，如果有大量同类测试可以通过复用服务实例的方式进一步优化性能。 #

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