Rails使用includes预加载嵌套关联时country记录未加载问题

嵌套关联未预加载问题由以下几个常见原因导致，按优先级排查修复即可： #

1. 模型定义存在基础语法/继承错误 #

你贴出的模型代码有两个致命错误，会直接导致关联配置不生效：

• Ruby中定义类的关键字为小写class，你使用了大写开头的Class，会直接触发语法错误，模型类无法正常加载
• ActiveRecord模型必须继承自ActiveRecord::Base，你直接继承了ActiveRecord模块，has_many、belongs_to这类关联注册方法不会被正确执行，关联关系根本没有生效。

修正后的模型代码如下：

class User < ActiveRecord::Base
  has_many :addresses
end

class Address < ActiveRecord::Base
  belongs_to :country
end

class Country < ActiveRecord::Base
  has_many :addresses
end

2. 控制台显示错觉，实际预加载已生效 #

如果修正模型代码后，你在控制台直接执行User.includes(addresses: :country)仍看不到country记录，属于控制台的默认展示逻辑问题：
Rails控制台打印ActiveRecord关系对象时，默认调用inspect方法，只会展示第一层关联数据，不会递归展示第二层及以上的嵌套关联，这并不代表嵌套关联没有被预加载。

你可以通过两种方式验证预加载是否生效：

• 查看执行语句时的SQL日志，正确配置后会固定执行3条SQL，没有额外的单条country查询：

  SELECT * FROM users;
  SELECT * FROM addresses WHERE addresses.user_id IN (加载出的user id列表);
  SELECT * FROM countries WHERE countries.id IN (加载出的address对应的country id列表);
  

• 把预加载结果存入变量后手动访问嵌套关联，观察是否有额外SQL生成：

  # 执行预加载
  users = User.includes(addresses: :country).to_a
  # 访问嵌套关联，若日志无新的country查询语句则预加载成功
  users.first.addresses.first.country
  

3. 关联外键缺失 #

如果以上两点都确认无误仍加载失败，检查数据库表结构：addresses表必须存在country_id整数字段，且字段类型和countries表的主键id类型一致，否则belongs_to :country关联本身无法正常工作，自然无法完成预加载。

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