Rails has_many through关联生成SQL外键不符合预期如何解决

问题根因 #

has_many关联在未手动指定外键时，Rails会按默认约定将外键设置为「当前模型名小写 + _id」，也就是User模型上的has_many :friendships会默认去friendships表查询user_id字段，和你表结构实际使用的friend_a_id、friend_b_id字段不匹配，最终生成错误SQL。
此外你当前的关联逻辑存在遗漏：仅配置source: :friend_a只能查询到单向关联的好友，无法覆盖当前用户分别作为friend_a、friend_b的两种好友关系场景，返回的好友列表不完整。

修复方案 #

调整User模型关联配置 #

删除原有错误的friendships、friends关联定义，替换为分方向的关联配置，明确指定每个关联使用的外键：

class User < ApplicationRecord
  # 原有devise、主页、好友请求相关配置保持不变
  devise :database_authenticatable, :registerable,
         :recoverable, :rememberable, :validatable

  has_one :homepage
  has_many :friend_requests, foreign_key: "sender_id"
  has_many :pending_requests, foreign_key: "receiver_id", class_name: "FriendRequest"

  # 分方向定义好友关系关联，明确指定外键
  has_many :friendships_as_requester, class_name: "Friendship", foreign_key: "friend_a_id"
  has_many :friendships_as_accepter, class_name: "Friendship", foreign_key: "friend_b_id"

  # 分别关联两个方向的好友对象
  has_many :accepter_friends, through: :friendships_as_requester, source: :friend_b
  has_many :requester_friends, through: :friendships_as_accepter, source: :friend_a

  # 合并两个方向的结果得到完整好友列表
  def friends
    accepter_friends + requester_friends
  end
end

补充Friendship模型校验（可选） #

为避免重复创建好友关系、自己加自己为好友的异常数据，可在模型层增加校验：

class Friendship < ApplicationRecord
  belongs_to :friend_a, class_name: "User", foreign_key: "friend_a_id"
  belongs_to :friend_b, class_name: "User", foreign_key: "friend_b_id"

  validates :friend_a_id, uniqueness: { scope: :friend_b_id, message: "好友关系已存在" }
  validate :cannot_add_self

  private
  def cannot_add_self
    errors.add(:base, "不能添加自己为好友") if friend_a_id == friend_b_id
  end
end

验证结果 #

配置完成后重新在控制台执行查询，不会再出现查找user_id字段的错误SQL，同时可以正确返回用户的全量双向好友列表。

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