Rails/RSpec：如何为Handler编写无需POST请求的测试用例？

问题描述 #

我有一个负责在数据库中创建新记录的Handler，它从POST请求中获取参数并添加新记录。该Handler代码定义如下：

module Vehicles
  module Handlers
    class AddVehicle
      def initialize(vehicle_params)
        @vehicle_info = vehicle_params
      end

      def call
        create_vehicle
      end

      private

      def create_vehicle
        Vehicle.create!(@vehicle_info)
      end
    end
  end
end

我希望测试该类方法是否正常工作，但无需发送POST请求，也不需要使用factory_bot创建数据，只需在调用方法时传入参数。请问该如何测试这种行为？

解决方案 #

这其实很简单，你的AddVehicle Handler本身就是一个接收参数的纯Ruby类，完全可以直接在测试中构造参数哈希，实例化类并调用方法，直接验证数据库记录的创建结果。不需要依赖真实HTTP请求或者factory_bot。

下面是两种常用Ruby测试框架的实现示例：

1. 使用RSpec测试

假设你用RSpec作为测试框架，测试用例可以这么写：

RSpec.describe Vehicles::Handlers::AddVehicle do
  describe "#call" do
    it "成功创建符合参数的车辆记录" do
      # 构造模拟的参数哈希，对应POST请求会传入的参数
      test_vehicle_params = {
        make: "Toyota",
        model: "Camry",
        year: 2023,
        color: "深海蓝"
      }

      # 实例化Handler并执行创建逻辑
      handler = described_class.new(test_vehicle_params)
      handler.call

      # 验证数据库中是否生成了正确的记录
      created_vehicle = Vehicle.last
      expect(created_vehicle.make).to eq(test_vehicle_params[:make])
      expect(created_vehicle.model).to eq(test_vehicle_params[:model])
      expect(created_vehicle.year).to eq(test_vehicle_params[:year])
      expect(created_vehicle.color).to eq(test_vehicle_params[:color])
    end

    it "当参数不合法时抛出异常" do
      # 构造缺少必填字段的参数（假设model是必填项）
      invalid_params = { make: "Honda" }

      # 验证调用时是否触发了ActiveRecord的验证异常
      expect {
        described_class.new(invalid_params).call
      }.to raise_error(ActiveRecord::RecordInvalid)
    end
  end
end

2. 使用Minitest测试

如果你的项目用Minitest，思路完全一致：

require "minitest/autorun"

class AddVehicleHandlerTest < Minitest::Test
  def test_create_valid_vehicle_record
    vehicle_params = { make: "Ford", model: "F-150", year: 2022 }

    handler = Vehicles::Handlers::AddVehicle.new(vehicle_params)
    handler.call

    created_vehicle = Vehicle.last
    assert_equal vehicle_params[:make], created_vehicle.make
    assert_equal vehicle_params[:model], created_vehicle.model
    assert_equal vehicle_params[:year], created_vehicle.year
  end

  def test_raise_error_for_invalid_params
    invalid_params = {}

    assert_raises ActiveRecord::RecordInvalid do
      Vehicles::Handlers::AddVehicle.new(invalid_params).call
    end
  end
end

关键说明 #

• 测试前确保你的测试环境配置了数据库隔离（比如RSpec的use_transactional_fixtures，或者用database_cleaner），避免测试数据互相污染。
• 这种测试方式直接针对Handler的核心逻辑，不需要依赖路由、控制器等上层组件，属于单元测试的范畴，执行速度快且聚焦。
• 不需要factory_bot是因为我们直接构造了需要的参数哈希，完全能满足测试需求。

内容的提问来源于stack exchange，提问作者L.Wini