Rails中使用ar_lazy_preload懒加载关联模型的指定字段

问题场景 #

使用ar_lazy_preload实现懒加载时，希望仅预加载关联模型的部分属性而非全量字段。例如User与Person为一对一关联，执行User.lazy_preload(:person).all时，仅需加载Person的date_of_birth字段，期望流程是：

1. 初始执行仅查询用户表：SELECT * FROM users
2. 首次访问users.first.person.date_of_birth时，触发关联查询：SELECT people.date_of_birth, people.user_id FROM people WHERE people.user_id IN ($ids)

解决方案 #

方法1：直接在lazy_preload调用中指定查询约束

在lazy_preload的关联参数中，通过lambda表达式添加select限定，必须包含关联外键（如user_id），否则Active Record无法正确匹配关联对象：

# 加载用户，仅预加载Person的user_id和date_of_birth字段
users = User.lazy_preload(person: -> { select(:user_id, :date_of_birth) }).all

执行验证：

• 初始执行仅触发SELECT * FROM users
• 调用users.first.person.date_of_birth时，触发查询：SELECT "people"."user_id", "people"."date_of_birth" FROM "people" WHERE "people"."user_id" IN (?)

方法2：定义专用关联复用逻辑

如果需要多次使用该预加载规则，可以在User模型中定义一个带查询约束的专用关联：

class User < ApplicationRecord
  has_one :person
  # 定义仅加载指定字段的Person关联
  has_one :person_dob, -> { select(:user_id, :date_of_birth) }, class_name: 'Person'
end

使用时直接调用该关联的懒加载：

users = User.lazy_preload(:person_dob).all
# 访问指定字段
users.first.person_dob.date_of_birth

注意事项 #

• 必须包含关联外键：Active Record需要通过外键（如user_id）将查询到的关联记录与主模型实例绑定，缺失会导致关联对象无法正确加载。
• 避免访问未加载字段：如果后续访问Person的其他未在select中指定的字段，会触发额外的全量查询，若仅需特定字段，建议严格限定访问范围。

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