Rails 5 Puma服务器并发请求时频繁冻结，求助解决方案

看起来你碰到的问题大概率是模块里的共享实例变量引发的线程安全问题——这在Puma多线程模式下非常常见，尤其是当多个并发请求同时操作同一个共享状态的时候。咱们一步步拆解：

一、为什么模块共享变量会导致冻结？ #

首先得明确一个Rails的基础逻辑：每个HTTP请求都会创建一个独立的控制器实例，但如果你的共享模块里使用了模块级的实例变量（比如直接在模块里定义@search_results，而不是在控制器方法内为当前实例初始化），这个变量会被所有包含该模块的控制器实例共享。

当6个并发请求同时进来时，多个线程会同时读写这个共享变量，轻则引发竞态条件（结果被覆盖），重则导致死锁——这完全符合你看到的“90%概率冻结”的现象，调大worker数只是把竞争分散到了更多独立进程里，所以概率降低，但根本问题没解决。

二、快速验证这个猜测 #

你可以给模块里的变量加个线程ID日志，看看是不是多个线程在抢同一个变量：

# 你的共享模块代码里
def perform_search
  Rails.logger.info "线程ID #{Thread.current.object_id} 开始写入@search_results"
  @search_results = SomeModel.search(params[:query])
  Rails.logger.info "线程ID #{Thread.current.object_id} 写入完成，结果数量：#{@search_results.size}"
end

触发6个并发请求后，如果日志里出现多个线程同时操作@search_results，那就能实锤是共享变量的锅了。

三、更安全的控制器逻辑复用方案 #

既然共享实例变量有问题，咱们换几种线程安全的方式来复用逻辑：

1. 用Rails关注点（Concern），确保变量是实例级 #

Rails官方推荐用Concern来复用控制器逻辑，只要确保所有实例变量都是当前控制器实例专属的就行：

# app/controllers/concerns/searchable.rb
module Searchable
  extend ActiveSupport::Concern

  included do
    # 每个控制器实例都会执行这个回调，没问题
    before_action :sanitize_search_params
  end

  private

  def sanitize_search_params
    # 这个@search_params是当前请求的控制器实例变量，完全独立
    @search_params = params.permit(:query, :filters)
  end

  def run_search(model_class)
    # 把结果存到当前实例的@search_results里，每个请求互不干扰
    @search_results = model_class.search(@search_params)
  end
end

然后在控制器里引入：

class UsersController < ApplicationController
  include Searchable

  def search
    run_search(User)
    render json: @search_results
  end
end

2. 用服务对象（Service Object）彻底解耦 #

把搜索逻辑从控制器里抽出来做成独立服务，每个请求创建一个服务实例，完全隔离状态：

# app/services/search_service.rb
class SearchService
  def initialize(params)
    @params = params.permit(:query, :filters)
  end

  def execute(model_class)
    model_class.search(@params)
  end
end

控制器里调用的时候，每次都是新的服务实例：

class ProductsController < ApplicationController
  def search
    search_results = SearchService.new(params).execute(Product)
    render json: search_results
  end
end

这种方式不仅线程安全，还让代码更清晰，后期维护也方便。

3. 用高阶控制器继承 #

如果多个控制器的逻辑高度相似，可以建一个基类控制器，其他控制器继承它：

class BaseSearchController < ApplicationController
  private

  def perform_search(model_class)
    @search_results = model_class.search(params.permit(:query, :filters))
  end
end

class PostsController < BaseSearchController
  def search
    perform_search(Post)
    render json: @search_results
  end
end

基类里的实例变量也是每个子控制器实例独有的，不会出现共享问题。

四、Puma配置的补充建议 #

调大worker数只是临时缓解，合理的配置应该是：

• Worker数建议等于服务器的CPU核心数（比如4核就设workers 4）
• 线程数设置为threads 5, 10（最小5，最大10），这个范围既能处理并发，又不会因为线程过多导致上下文切换开销过大

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