Rails创建多层嵌套关联时外键为nil的问题排查

问题场景 #

我有四个Rails模型：App、AppPortal、AppPortalVersion和AppPortalConfiguration，关联配置如下：

class App < ApplicationRecord
  self.table_name = :apps
  has_one :app_portal, class_name: 'AppPortal'
end

class AppPortal < ApplicationRecord
  self.table_name = :app_portals
  belongs_to :app, class_name: 'App'
  has_many :app_portal_versions,
           class_name: 'AppPortalVersion',
           foreign_key: :app_portal_id
  accepts_nested_attributes_for :app_portal_versions
end

class AppPortalVersion < ApplicationRecord
  self.table_name = :app_portal_versions
  belongs_to :app_portal,
              class_name: 'AppPortal',
              foreign_key: :app_portal_id
  has_one :app_portal_configuration,
          class_name: 'AppPortalConfiguration',
          foreign_key: :app_portal_version_id
  accepts_nested_attributes_for :app_portal_configuration
end

class AppPortalConfiguration < ApplicationRecord
  self.table_name = :app_portal_configurations
  belongs_to :app_portal_version,
             class_name: 'AppPortalVersion',
             foreign_key: :app_portal_version_id
end

尝试为已存在的App创建嵌套关联时，执行以下代码：

app = App.first
app_portal = app.build_app_portal
app_portal_version = app_portal.app_portal_versions.build
app_portal_version.build_app_portal_configuration
app_portal.save!

结果只有app_portal的app_id正确赋值，其余对象的外键均为nil：

puts app_portal
=> #<AppPortal:0x000000011bc6d420 id: nil, app_id: 18>

puts app_portal_version
=> #<AppPortalVersion:0x000000011b3658c8 id: nil, app_portal_id: nil>

puts app_portal_version.app_portal_configuration
=> #<AppPortalConfiguration:0x000000012fb264e0 id: nil, app_portal_version_id: nil>

最终保存失败，报错：

ActiveRecord::RecordInvalid: Validation failed: App portal versions app portal must exist, App portal versions app portal configuration app portal version must exist

解决方案 #

方案1：允许belongs_to关联临时为空（推荐） #

Rails 5+ 默认给belongs_to关联添加presence: true验证，未保存的父对象因为没有ID，会导致子对象的外键验证失败。给关联添加optional: true，允许外键临时为nil，保存时Rails会自动填充正确的外键值：

修改AppPortalVersion模型：

class AppPortalVersion < ApplicationRecord
  self.table_name = :app_portal_versions
  belongs_to :app_portal,
              class_name: 'AppPortal',
              foreign_key: :app_portal_id,
              optional: true # 添加此行
  # 其余代码保持不变
end

修改AppPortalConfiguration模型：

class AppPortalConfiguration < ApplicationRecord
  self.table_name = :app_portal_configurations
  belongs_to :app_portal_version,
             class_name: 'AppPortalVersion',
             foreign_key: :app_portal_version_id,
             optional: true # 添加此行
end

修改后原代码即可正常运行，save!会自动保存所有嵌套对象并填充外键。

方案2：使用嵌套属性一次性创建 #

通过App的嵌套属性来创建所有关联对象，先给App添加accepts_nested_attributes_for：

修改App模型：

class App < ApplicationRecord
  self.table_name = :apps
  has_one :app_portal, class_name: 'AppPortal'
  accepts_nested_attributes_for :app_portal # 添加此行
end

然后用嵌套属性的方式创建：

app = App.first
app.update!(
  app_portal_attributes: {
    app_portal_versions_attributes: [
      {
        app_portal_configuration_attributes: {}
      }
    ]
  }
)

这种方式下Rails会自动处理所有对象的保存顺序和外键赋值，无需手动分步创建。

方案3：手动分步保存 #

如果不想修改验证规则，可以分步保存每个对象，确保父对象生成ID后再创建子对象：

app = App.first
app_portal = app.create_app_portal # 先保存app_portal，生成ID
app_portal_version = app_portal.app_portal_versions.create! # 自动赋值app_portal_id
app_portal_version.create_app_portal_configuration! # 自动赋值app_portal_version_id

这种方式需要依次保存每个层级的对象，确保父对象存在ID后再创建子对象。

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