Rails ActiveRecord关联模型访问为空需显式加载的异常问题咨询

问题场景 #

Shipment模型定义： #

class Shipment < ApplicationRecord
  has_many :items

  def can_add_all_items_to_work_order?
    return false if items.empty?
    items.all? { |i| i.assignable_to_work_order? }
  end
end

异常表现： #

在控制器中执行：

shipment = Shipment.find(params[:shipment_id])
shipment.can_add_all_items_to_work_order? # 返回false，错误判定items为空

但数据库中存在该Shipment关联的Item记录，方法本应返回true。

若先显式访问关联：

shipment = Shipment.find(params[:shipment_id])
shipment.items # 显式触发关联加载
shipment.can_add_all_items_to_work_order? # 返回预期的true

疑问解答 #

1. 为什么方法会判定items为空？ #

这是因为Rails关联延迟加载时，empty?方法的执行逻辑和显式调用items不同：

• 当关联未加载时，items.empty?会执行一条轻量查询：SELECT 1 FROM items WHERE shipment_id = ? LIMIT 1，只要这条查询无结果，就会返回true。
• 如果这条查询因为事务隔离、未提交数据、Item模型的默认作用域/过滤条件（比如软删除字段默认过滤）导致无结果，就会错误判定为空。
• 而显式调用shipment.items会触发完整的关联加载（SELECT * FROM items WHERE shipment_id = ?），此时会获取到真实的记录，后续empty?会用内存数据判断，结果正确。

2. 为什么控制台能复现加载日志，控制器中不行？ #

• 控制台默认是自动提交事务，且日志级别为debug，所有SQL都会输出；而控制器中如果请求处于事务块内（比如框架自动开启的事务），部分SQL会延迟到事务提交时执行，或日志级别被设置为info及以上，导致看不到SELECT 1的查询日志。
• 另外，控制台调用shipment.items会直接触发完整加载，而控制器中empty?返回true后，all?不会再执行，也就不会触发后续的Item加载请求，自然看不到对应日志。

3. 为什么预加载includes(:items)后恢复正常？ #

includes(:items)会在加载Shipment时，通过IN查询一次性预加载所有关联的Item数据并存入内存。此时调用items.empty?会直接使用内存中的完整数据判断，不会执行延迟加载时的SELECT 1轻量查询，从而避开了之前导致错误的查询逻辑，结果自然正确。

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