Rails 6.1 has_one关联报错：can't write unknown attribute `session_summary_id`

你的问题核心是关联方向、外键配置和数据库字段设置完全搞反，导致Rails无法找到正确的关联字段，具体问题点和修复步骤如下：

问题点分析 #

1. 关联逻辑颠倒
   Rails中has_one和belongs_to的核心规则是：外键字段必须放在belongs_to的模型表中。你要实现「一个Session对应一个SessionSummary」，正确逻辑应该是Session拥有SessionSummary，SessionSummary属于Session，但你的外键配置完全写反了。

2. 外键名称与数据库字段不匹配

   • 你在Session模型的has_one中设置foreign_key: 'session_summary_id'，会让Rails尝试给Session表写入session_summary_id字段，但这个字段的逻辑应该放在SessionSummary表中。
   • SessionSummary模型里的belongs_to :session, foreign_key: 'session_summary_id'完全错误，这会让Rails去SessionSummary表找不存在的session_summary_id字段。

3. 迁移文件字段错误
   你在CreateSessions迁移里给sessions表加了session_summary外键，但按照关联逻辑，这个外键应该加在session_summaries表中，指向sessions表的uuid主键。

修复步骤 #

1. 修正模型关联代码 #

# app/models/session.rb
class Session < ApplicationRecord
  self.implicit_order_column = 'created_at'

  belongs_to :consultant
  belongs_to :professional
  has_one :session_summary, dependent: :destroy
end

# app/models/session_summary.rb
class SessionSummary < ApplicationRecord
  validates :objectives, presence: true

  belongs_to :session
end

2. 修正数据库迁移 #

情况1：未执行原迁移

直接修改原迁移文件：

# db/migrate/xxxx_create_session_summaries.rb
class CreateSessionSummaries < ActiveRecord::Migration[6.1]
  def change
    create_table :session_summaries do |t|
      t.string :objectives, null: false
      # 添加指向session的uuid类型外键
      t.uuid :session_id, null: false, foreign_key: true
      t.timestamps
    end
  end
end

# db/migrate/xxxx_create_sessions.rb
class CreateSessions < ActiveRecord::Migration[6.1]
  def change
    create_table :sessions, id: :uuid do |t|
      t.timestamps
    end

    add_reference :sessions, :professional, type: :uuid, null: false, foreign_key: true
    add_reference :sessions, :consultant, type: :uuid, null: false, foreign_key: true
    # 删掉错误的session_summary外键配置
  end
end

情况2：已执行原迁移

生成新迁移来修正：

rails generate migration FixSessionSessionSummaryAssociation

编辑新迁移文件：

class FixSessionSessionSummaryAssociation < ActiveRecord::Migration[6.1]
  def change
    # 删除sessions表中错误的外键
    remove_reference :sessions, :session_summary, type: :bigint, foreign_key: true
    # 给session_summaries表添加正确的uuid外键
    add_reference :session_summaries, :session, type: :uuid, null: false, foreign_key: true
  end
end

3. 修正赋值代码 #

你之前的赋值逻辑错误，把Session对象赋值给自己的关联属性，正确写法：

s = Session.new
ss = SessionSummary.new(objectives: "示例目标") # 需满足objectives非空验证
s.session_summary = ss

核心规则回顾 #

• belongs_to 对应的模型表必须保存关联对象的外键，格式为关联名_id（比如session_id）
• has_one 是反向关联，自身表不需要存外键，由关联的belongs_to表存储
• 外键类型必须和关联表的主键类型匹配（这里Session用uuid，外键也要设为uuid类型）

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