使用jsonapi.rb与Ransack构建的API：如何在color_in筛选参数中同时传入多值与空值(nil)

我之前也碰到过类似的场景，Ransack本身支持_in多值查询和NULL筛选，但直接传nil字符串它是不会自动识别成Ruby的nil的，得做一点小处理才行。这里给你两种可行的方案：

方案一：控制器层处理参数转换（简单直接） #

在你的CarsController的index动作里，先把传入的filter[color_in]参数里的"nil"字符串转换成真正的nil值，再传给Ransack：

def index
  if params.dig(:filter, :color_in)
    # 分割参数字符串，逐个转换值："nil"转成nil，其他转成整数
    color_values = params[:filter][:color_in].split(',').map do |val|
      val == 'nil' ? nil : val.to_i
    end
    # 构建Ransack查询参数
    ransack_query = { color_in: color_values }
    @q = Car.ransack(ransack_query)
  else
    @q = Car.ransack(params[:q])
  end
  # 执行查询（distinct: true避免重复结果，可选）
  @cars = @q.result(distinct: true)
  # 用jsonapi.rb渲染结果
  render jsonapi: @cars
end

这样当你请求/cars?filter[color_in]=1,2,nil时，color_values会变成[1, 2, nil]，Ransack会自动生成正确的SQL条件——既匹配color为1、2的记录，也匹配color为NULL的记录（它会把数组里的nil转换成color IS NULL的条件，而不是直接写IN (1,2,NULL)，这点不用担心）。

方案二：模型层自定义Ransacker（解耦控制器逻辑） #

如果不想让控制器处理太多参数转换的逻辑，可以在Car模型里自定义一个Ransacker，让它自动识别参数里的"nil"：

class Car < ApplicationRecord
  # 自定义支持nil字符串的color_in查询器
  ransacker :color_in, formatter: ->(values) {
    values.map { |v| v == 'nil' ? nil : v.to_i }
  } do |parent|
    parent.table[:color]
  end
end

然后在控制器里只需要把jsonapi的filter参数映射到Ransack的查询参数即可：

def index
  # 把jsonapi的filter键转换成Ransack的_in后缀格式
  ransack_params = params[:filter]&.transform_keys { |key| "#{key}_in" }
  @q = Car.ransack(ransack_params)
  @cars = @q.result(distinct: true)
  render jsonapi: @cars
end

这个方案把参数转换的逻辑放到了模型层，控制器更清爽，适合多个地方需要用到相同筛选逻辑的场景。

注意事项 #

• 因为你的color是整数类型，一定要确保非"nil"的参数都转换成整数，避免Ransack查询时出现类型不匹配的错误。
• Ransack处理包含nil的_in查询时，会自动生成color IN (?, ?) OR color IS NULL这样的SQL，而不是无效的IN (?, ?, NULL)，所以不用手动拼接条件。

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