Rails关联查询数据时API返回未包含关联学生的问题排查

我有一个与schools表关联的students表，调用API获取所有学校数据时，响应里不包含关联的学生数据，但奇怪的是在终端循环打印时能看到学生姓名。我试过用has_many :student, foreign_key: :school_id, primary_key: :id也没解决，请问这是为什么？

相关代码 #

表结构说明 #

students表包含引用schools表的school_id字段。

schools_controller.rb #

class SchoolsController < ApplicationController
  def index
    schools = School.includes(:student)

    schools.each do |school|
      puts school.student.collect(&:name) # 终端能打印出学生姓名
    end

    render json: { message: "sample", data: schools }, status: :ok
  end
end

school.rb #

class School < ApplicationRecord
    has_many :student
end

student.rb #

class Student < ApplicationRecord
end

12345_create_students.rb #

class CreateStudents < ActiveRecord::Migration[7.0]
  def change
    create_table :students do |t|
      t.references :school, foreign_key: true
      t.string :name
      ...
    end
  end
end

1. 关联命名违反Rails约定 #

Rails的has_many关联要求使用复数形式，你写的has_many :student是单数，这会导致关联映射异常。虽然终端打印时Rails做了容错处理能获取数据，但序列化时会出现问题。

修正school.rb：

class School < ApplicationRecord
  has_many :students # 改为复数students
end

同时控制器里的预加载和循环代码也要对应修改：

schools = School.includes(:students)

schools.each do |school|
  puts school.students.collect(&:name)
end

2. 默认JSON序列化不包含关联数据 #

即使预加载了关联数据，Rails默认只会序列化模型自身的属性，不会自动带上关联的students。必须明确指定要包含的关联：

快速解决：render时用as_json指定include #

修改控制器的render代码：

render json: { 
  message: "sample", 
  data: schools.as_json(include: :students) 
}, status: :ok

更灵活的方案：使用序列化器 #

创建序列化器来精准控制输出结构：

# app/serializers/school_serializer.rb
class SchoolSerializer < ActiveModel::Serializer
  attributes :id, :name # 替换为学校实际需要输出的属性
  has_many :students
end

# app/serializers/student_serializer.rb
class StudentSerializer < ActiveModel::Serializer
  attributes :id, :name
end

然后控制器中使用序列化器：

render json: { 
  message: "sample", 
  data: SchoolSerializer.new(schools).serializable_hash 
}, status: :ok

3. 补充：完善反向关联（可选） #

为了让关联关系更完整，建议在Student模型中添加反向关联：

class Student < ApplicationRecord
  belongs_to :school
end

内容的提问来源于stack exchange，提问作者アリ・ナディム