如何修复空数组场景下的ArgumentError：无法推断集合根键报错

这个报错的核心原因是：当你要序列化的集合是空数组时，ActiveModel Serializers没办法自动推断根键（毕竟没有元素能帮它识别对应的模型类型），所以抛出了Cannot infer root key from collection type的错误。

给你两种简单可行的修复方案，任选其一就能解决问题：

方案一：添加root: false参数 #

直接在render json:的调用里加上root: false，告诉序列化器不要自动添加根键，直接返回数组结构（不管是空还是有数据）：

def booked_cars
  if params["id"].present?
    @customer = Customer.find(params["id"].to_i)
    # 把collect换成map更符合Ruby习惯，功能完全一致
    @booked_cars = @customer.bookings.where(cancelled: false).map(&:used_car)
    render json: @booked_cars, each_serializer: UsedCarSerializer, root: false
  end
end

方案二：显式使用CollectionSerializer #

用ActiveModel::Serializer::CollectionSerializer来包裹你的集合，这样不管集合是否为空，序列化器都能明确知道该用哪个序列化器处理每个元素：

def booked_cars
  if params["id"].present?
    @customer = Customer.find(params["id"].to_i)
    @booked_cars = @customer.bookings.where(cancelled: false).map(&:used_car)
    render json: ActiveModel::Serializer::CollectionSerializer.new(
      @booked_cars,
      each_serializer: UsedCarSerializer
    )
  end
end

额外性能优化建议 #

顺便提一句，你的代码目前存在N+1查询的问题——每次遍历booking去取used_car都会发一次SQL请求。可以用includes预加载关联数据，大幅提升接口性能：

@booked_cars = @customer.bookings.where(cancelled: false).includes(:used_car).map(&:used_car)

这样修改后，不管@booked_cars是空数组还是包含数据的数组，都能正常返回JSON，不会再触发那个ArgumentError啦。

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