Ruby on Rails中pluck方法触发NilClass错误的原因排查求助

问题背景 #

在Ruby on Rails开发中调用get_associations方法时，触发NoMethodError: undefined method 'pluck' for nil:NilClass错误，错误指向records.pluck(:client_id)代码行。但通过binding.pry调试时，records是一个非空数组，且pluck(:client_id)能正常返回结果：

49: def get_associations(records, tuples)
 => 50:   binding.pry
    51:   ClientAssociatedLocation.with_deleted.
    52:     where(client_id: records.pluck(:client_id)).
    53:     where("CONCAT_WS('-', client_id, location_id) IN (?)", tuples)
    54: end

调试输出：

[1] pry(#<AssociatedLocations::SourcesCreator>)> records
=> [{:id=>nil, :user_id=>nil, :client_id=>1523, :location_id=>2257, :association_type=>"manual"}]
[2] pry(#<AssociatedLocations::SourcesCreator>)> records.pluck(:client_id)
=> [1523]

可能原因 #

• 多场景调用时参数为空：你调试的只是某一次成功的调用，但get_associations可能在其他场景被调用，此时传入的records参数为nil。比如循环处理数据时某次循环的records未赋值、异步任务调用时参数传递出错等。
• 代码分支差异：如果调用get_associations前存在条件逻辑，调试时走的是records有值的分支，但报错场景触发了另一个分支，导致records被赋值为nil。

解决建议 #

• 检查所有调用入口：全局搜索get_associations的调用位置，确认每个场景下传入的records都已正确初始化，不会出现nil。
• 添加参数防护逻辑：修改方法，提前处理nil或空数组的情况，避免报错：

  def get_associations(records, tuples)
    return ClientAssociatedLocation.none if records.nil? || records.empty?
    
    ClientAssociatedLocation.with_deleted.
      where(client_id: records.pluck(:client_id)).
      where("CONCAT_WS('-', client_id, location_id) IN (?)", tuples)
  end
  

• 添加日志定位问题：在方法开头加入日志，记录每次调用的records状态，方便追踪报错场景：

  def get_associations(records, tuples)
    Rails.logger.info "get_associations invoked, records: #{records.inspect}"
    
    ClientAssociatedLocation.with_deleted.
      where(client_id: records.pluck(:client_id)).
      where("CONCAT_WS('-', client_id, location_id) IN (?)", tuples)
  end
  

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