如何在Rails 5 API应用中用RSpec测试Controller Concern方法

我来帮你梳理下这个问题，先从测试类型和你的错误原因说起：

应该用controller测试，因为你的Response concern是给控制器实例提供实例方法的，controller测试可以直接针对控制器实例的方法进行验证；而request测试更适合端到端的请求流程测试，不太适合单独验证concern的方法逻辑。

你当前的错误核心是搞混了方法类型：json_response是实例方法，但你用expect(controller_class).to respond_to(:json_response)检查的是类是否响应这个方法——类方法是定义在类本身的，而你的concern里的def json_response是实例方法，只能被控制器的实例调用，所以这个断言必然失败。

1. 改进Shared Examples #

把shared examples改成针对控制器实例的验证，同时增加对方法实际行为的测试（不仅仅是验证方法存在）：

# spec/shared/json_response.rb
require 'rails_helper'

RSpec.shared_examples 'JSON Responsive controller' do
  # 验证控制器实例能调用该方法
  it 'provides json_response instance method' do
    expect(controller).to respond_to(:json_response)
  end

  # 验证方法的实际行为：渲染正确的JSON、状态码和额外选项
  it 'renders JSON with specified status and options' do
    test_payload = { message: 'hello world' }
    custom_status = :created
    extra_opts = { content_type: 'application/json; charset=utf-8' }

    # 直接在控制器实例上调用方法
    controller.json_response(test_payload, custom_status, extra_opts)

    # 验证响应结果
    expect(response).to have_http_status(custom_status)
    expect(JSON.parse(response.body)).to eq(test_payload)
    expect(response.content_type).to eq(extra_opts[:content_type])
  end
end

2. 完善Fake Controller测试 #

需要给fake controller加一个测试用的action（或者直接调用实例方法），还要临时添加路由避免controller测试报错：

# spec/controllers/concerns/fake_controller_spec.rb
require 'rails_helper'

# 定义测试用的Fake Controller
class FakeController < ApplicationController
  # 可选：加一个action来模拟实际调用场景
  def test_json_response
    json_response({ data: 'test' }, :ok)
  end
end

# 临时添加路由，让controller测试能正常运行
Rails.application.routes.draw do
  get 'fake/test_json_response' => 'fake#test_json_response'
end

RSpec.describe FakeController, type: :controller do
  # 使用shared examples
  it_behaves_like 'JSON Responsive controller'

  # 额外：测试实际action调用的效果，模拟真实业务场景
  describe 'GET #test_json_response' do
    it 'returns valid JSON response with correct status' do
      get :test_json_response

      expect(response).to be_successful
      expect(JSON.parse(response.body)).to eq({ 'data' => 'test' })
    end
  end
end

• 如果你想全面测试concern逻辑，最好覆盖不同状态码、额外选项（比如location、headers）的场景，确保merge后的参数正确传递给render。
• 也可以直接在真实的控制器测试中复用这个shared examples，不用单独写fake controller，比如在ApplicationController的测试里或者其他引入了该concern的控制器测试里使用。

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